From d7807fb67e5d4ca84d8d5dd928273a340f3650ce Mon Sep 17 00:00:00 2001
From: Andras Szucs <andras@andras.codes>
Date: Tue, 9 Jun 2026 18:04:00 +0200
Subject: [PATCH] docs(wallets): update web documentation

---
 docs/pages/wallets/auth/email-otp.mdx         |  15 +-
 docs/pages/wallets/auth/google-oauth.mdx      |  12 +-
 docs/pages/wallets/auth/magic-link.mdx        |  17 +-
 docs/pages/wallets/connector-options.mdx      | 145 ++++++++++++++++++
 .../wallets/hooks/use-authenticators.mdx      |  87 +++++++++++
 .../wallets/hooks/use-get-user-email.mdx      |  56 -------
 .../wallets/hooks/use-send-magic-link.mdx     |  34 ++--
 docs/pages/wallets/hooks/use-send-otp.mdx     |  31 ++--
 .../wallets/hooks/use-verify-magic-link.mdx   |  23 ++-
 docs/pages/wallets/hooks/use-verify-otp.mdx   |  28 +++-
 docs/pages/wallets/quickstart.mdx             |   2 +
 docs/pages/wallets/session-management.mdx     |   2 +-
 vocs.config.tsx                               |  12 +-
 13 files changed, 362 insertions(+), 102 deletions(-)
 create mode 100644 docs/pages/wallets/connector-options.mdx
 create mode 100644 docs/pages/wallets/hooks/use-authenticators.mdx
 delete mode 100644 docs/pages/wallets/hooks/use-get-user-email.mdx

diff --git a/docs/pages/wallets/auth/email-otp.mdx b/docs/pages/wallets/auth/email-otp.mdx
index c7aaf37..9309b04 100644
--- a/docs/pages/wallets/auth/email-otp.mdx
+++ b/docs/pages/wallets/auth/email-otp.mdx
@@ -21,7 +21,10 @@ import { useSendOTP, useVerifyOTP } from '@zerodev/wallet-react'
 function EmailOTPAuth() {
   const [email, setEmail] = useState('')
   const [code, setCode] = useState('')
-  const [otpId, setOtpId] = useState<string | null>(null)
+  const [otp, setOtp] = useState<{
+    otpId: string
+    otpEncryptionTargetBundle: string
+  } | null>(null)
 
   const { address, isConnected } = useAccount()
   const { disconnectAsync } = useDisconnect()
@@ -37,7 +40,7 @@ function EmailOTPAuth() {
     )
   }
 
-  if (!otpId) {
+  if (!otp) {
     return (
       <div>
         <input
@@ -49,7 +52,7 @@ function EmailOTPAuth() {
         <button
           onClick={async () => {
             const result = await sendOTP.mutateAsync({ email })
-            setOtpId(result.otpId)
+            setOtp(result)
           }}
           disabled={sendOTP.isPending || !email}
         >
@@ -70,7 +73,7 @@ function EmailOTPAuth() {
         onChange={(e) => setCode(e.target.value)}
       />
       <button
-        onClick={() => verifyOTP.mutateAsync({ code, otpId })}
+        onClick={() => verifyOTP.mutateAsync({ code, ...otp })}
         disabled={verifyOTP.isPending || !code}
       >
         {verifyOTP.isPending ? 'Verifying...' : 'Verify Code'}
@@ -83,8 +86,8 @@ function EmailOTPAuth() {
 
 ## How it works
 
-1. **Send code**: `useSendOTP` sends a one-time verification code to the provided email address. It returns an `otpId` that identifies this verification attempt.
+1. **Send code**: `useSendOTP` sends a one-time verification code to the provided email address. It returns an `otpId` and `otpEncryptionTargetBundle` that identify and bind this verification attempt.
 
-2. **Verify code**: `useVerifyOTP` takes the `otpId` and the code the user entered. If the code is valid, the SDK authenticates and creates a session.
+2. **Verify code**: `useVerifyOTP` takes the `otpId`, `otpEncryptionTargetBundle`, and the code the user entered. If the code is valid, the SDK authenticates and creates a session.
 
 After verification, the Wagmi connector is connected and the user's address is available via `useAccount`.
diff --git a/docs/pages/wallets/auth/google-oauth.mdx b/docs/pages/wallets/auth/google-oauth.mdx
index 602d6e5..9ea3f25 100644
--- a/docs/pages/wallets/auth/google-oauth.mdx
+++ b/docs/pages/wallets/auth/google-oauth.mdx
@@ -8,7 +8,7 @@
 This page covers the web flow. For Expo / React Native, see [Google OAuth on React Native](/wallets/react-native/google-oauth).
 :::
 
-Google OAuth lets users sign in with their Google account using a popup-based flow. The SDK handles the popup, redirect, and session creation automatically.
+Google OAuth lets users sign in with their Google account using a popup-based flow. The SDK handles the popup, redirect back to your app, and session creation automatically.
 
 By default, the Google OAuth flow uses a Zerodev-managed Google account for authentication. This allows you to get started quickly without any additional configuration. You can customize the OAuth flow by providing your own Google OAuth client ID and secret in the developer dashboard.
 
@@ -66,14 +66,14 @@ function GoogleAuth() {
 
 ## How it works
 
-1. **Open popup**: `useAuthenticateOAuth` opens a popup window to the KMS backend's OAuth endpoint.
+1. **Request login URL**: `useAuthenticateOAuth` asks the backend for a Google OAuth login URL tied to the wallet's current public key.
 
-2. **Google sign-in**: The backend initiates the Google OAuth flow with PKCE. The user signs in with their Google account.
+2. **Verify login URL**: Before opening the popup, the SDK verifies the returned Google login URL so the OAuth flow stays bound to the expected wallet public key.
 
-3. **Backend callback**: Google redirects back to the backend, which exchanges the auth code for tokens and sets a session cookie.
+3. **Open popup**: The SDK opens a popup to that verified Google login URL and polls the popup while the user signs in with Google.
 
-4. **Popup redirect**: The backend redirects the popup to your app with `?oauth_success=true`.
+4. **Popup redirect**: After a successful sign-in, the popup returns to your app's origin with `?oauth_success=true&session_id=...`.
 
-5. **Auto-detect**: The SDK detects the success parameter. If running in a popup, it sends a `postMessage` to the opener window and closes. The main window then calls the backend's auth endpoint (reading the session cookie) to get a session.
+5. **Complete auth**: The SDK reads `session_id` from the popup URL, completes wallet authentication with it, and then connects the Wagmi connector.
 
 After the flow completes, the Wagmi connector is connected and the user's address is available via `useAccount`.
diff --git a/docs/pages/wallets/auth/magic-link.mdx b/docs/pages/wallets/auth/magic-link.mdx
index db184f3..634c1cb 100644
--- a/docs/pages/wallets/auth/magic-link.mdx
+++ b/docs/pages/wallets/auth/magic-link.mdx
@@ -41,8 +41,12 @@ function MagicLinkLogin() {
             email,
             redirectURL: `${window.location.origin}/verify`,
           })
-          // Store otpId for the verify page
+          // Store both values for the verify page
           sessionStorage.setItem('magicLinkOtpId', result.otpId)
+          sessionStorage.setItem(
+            'magicLinkOtpEncryptionTargetBundle',
+            result.otpEncryptionTargetBundle,
+          )
         }}
         disabled={sendMagicLink.isPending || !email}
       >
@@ -78,9 +82,12 @@ function VerifyMagicLink() {
   useEffect(() => {
     const code = searchParams.get('code')
     const otpId = sessionStorage.getItem('magicLinkOtpId')
+    const otpEncryptionTargetBundle = sessionStorage.getItem(
+      'magicLinkOtpEncryptionTargetBundle',
+    )
 
-    if (code && otpId && !isConnected) {
-      verifyMagicLink.mutateAsync({ otpId, code })
+    if (code && otpId && otpEncryptionTargetBundle && !isConnected) {
+      verifyMagicLink.mutateAsync({ otpId, code, otpEncryptionTargetBundle })
     }
   }, [searchParams])
 
@@ -102,10 +109,10 @@ function VerifyMagicLink() {
 
 ## How it works
 
-1. **Send link**: `useSendMagicLink` sends an email with a magic link pointing to your `redirectURL`. It returns an `otpId` that you need for verification.
+1. **Send link**: `useSendMagicLink` sends an email with a magic link pointing to your `redirectURL`. It returns an `otpId` and `otpEncryptionTargetBundle` that you need for verification.
 
 2. **User clicks link**: The user clicks the link in their email, which redirects them to your app with a `code` query parameter.
 
-3. **Verify**: Your verify page calls `useVerifyMagicLink` with the `otpId` and `code`. If valid, the SDK authenticates and creates a session.
+3. **Verify**: Your verify page calls `useVerifyMagicLink` with the `otpId`, `otpEncryptionTargetBundle`, and `code`. If valid, the SDK authenticates and creates a session.
 
 After verification, the Wagmi connector is connected and the user's address is available via `useAccount`.
diff --git a/docs/pages/wallets/connector-options.mdx b/docs/pages/wallets/connector-options.mdx
new file mode 100644
index 0000000..0a42be0
--- /dev/null
+++ b/docs/pages/wallets/connector-options.mdx
@@ -0,0 +1,145 @@
+# Connector Options [Configure the zeroDevWallet connector]
+
+:::danger[IMPORTANT]
+**USE FOR INTERNAL TESTING PURPOSES ONLY.** You may use these features solely for internal evaluation purposes on supported testnets. DO NOT use for production use or share with your users. Wallets created during this preview ("Alpha Wallets") will be discontinued. Any tokens remaining within Alpha Wallets will be permanently lost upon discontinuance. Any mainnet tokens sent to an Alpha Wallet will not be deposited and will be permanently lost when discontinued. We are unable to help recover any lost funds from Alpha Wallets. We provide all previews on an "as is" basis without warranty of any kind, and we may terminate or suspend the availability of any preview at any time.
+:::
+
+The `zeroDevWallet` connector is configured through the options below. Only `projectId` and `chains` are required — on the web, everything else falls back to a sensible default.
+
+```tsx
+import { zeroDevWallet } from '@zerodev/wallet-react'
+import { sepolia } from 'wagmi/chains'
+
+zeroDevWallet({
+  projectId: 'YOUR_ZERODEV_PROJECT_ID',
+  chains: [sepolia],
+})
+```
+
+## Options
+
+### projectId
+
+`string`
+
+**Required.** Your ZeroDev project ID, from the [ZeroDev Dashboard](https://dashboard.zerodev.app/).
+
+### chains
+
+`readonly Chain[]`
+
+**Required.** The viem/wagmi chains the wallet supports. Usually the same array you pass to Wagmi's `createConfig`.
+
+### mode
+
+`'EOA' | '4337' | '7702'`
+
+The account mode exposed to Wagmi. Defaults to `'7702'`.
+
+- `'7702'` — An EOA delegated to a Kernel smart account via [EIP-7702](https://eips.ethereum.org/EIPS/eip-7702). The address equals the EOA address; transactions are bundled as UserOperations and can be sponsored.
+- `'4337'` — A counterfactual [ERC-4337](https://eips.ethereum.org/EIPS/eip-4337) Kernel smart account. The address differs from the EOA and the account is deployed on the first UserOperation; transactions are bundled as UserOperations.
+- `'EOA'` — A plain EOA. Transactions are sent directly via the chain's RPC, with no bundler and no sponsorship.
+
+### rpId
+
+`string | undefined`
+
+The relying party ID — the domain used for [passkeys](/wallets/auth/passkeys#configure-rp-id-optional), as defined by the [WebAuthn standard](https://web.dev/articles/webauthn-rp-id). On the web it defaults to `window.location.hostname`, so you only need to set it to share passkeys across subdomains.
+
+### autoRefreshSession
+
+`boolean | undefined`
+
+Whether the SDK refreshes the session before it expires. Defaults to `true`. See [Session Management](/wallets/session-management#auto-refresh-configuration).
+
+### sessionWarningThreshold
+
+`number | undefined`
+
+How long before expiry (in milliseconds) the session is refreshed when `autoRefreshSession` is enabled. Defaults to `60000` (60 seconds).
+
+### autoInitialize
+
+`boolean | (() => boolean) | undefined`
+
+Whether the connector initializes automatically on mount. When `false`, the connector still initializes lazily on connect. Accepts a function for conditional initialization.
+
+### sessionStorage
+
+`StorageAdapter | undefined`
+
+Storage adapter for the wallet SDK's session backend. This is where the auth/session layer stores its session records. On the web it defaults to the browser's `localStorage`. Provide a custom [`StorageAdapter`](/wallets/session-management#custom-storage) for alternative storage.
+
+### persistStorage
+
+`CreateStoreOptions['storage'] | undefined`
+
+Storage used to persist the connector store across page reloads. This is a separate layer from `sessionStorage`. If omitted, the connector store uses its own default web persistence behavior rather than automatically reusing `sessionStorage`.
+
+### Storage model on web
+
+There are two storage layers on the web:
+
+- `sessionStorage` stores the wallet SDK's auth/session data.
+- `persistStorage` stores the ZeroDev connector's persisted state for rehydration.
+
+Most apps can leave both unset and use the built-in web defaults:
+
+```tsx
+zeroDevWallet({
+  projectId: 'YOUR_ZERODEV_PROJECT_ID',
+  chains: [sepolia],
+})
+```
+
+If you want both layers to use the same browser storage implementation, set them both explicitly:
+
+```tsx
+const browserStorage = {
+  getItem: (key: string) => window.localStorage.getItem(key),
+  setItem: (key: string, value: string) =>
+    window.localStorage.setItem(key, value),
+  removeItem: (key: string) => window.localStorage.removeItem(key),
+}
+
+zeroDevWallet({
+  projectId: 'YOUR_ZERODEV_PROJECT_ID',
+  chains: [sepolia],
+  sessionStorage: browserStorage,
+  persistStorage: browserStorage,
+})
+```
+
+### apiKeyStamper
+
+`ApiKeyStamper | Promise<ApiKeyStamper> | undefined`
+
+Advanced. Signs the SDK's requests with an API key. On the web it defaults to an IndexedDB-backed stamper.
+
+### passkeyStamper
+
+`PasskeyStamper | Promise<PasskeyStamper> | undefined`
+
+Advanced. Signs passkey operations. On the web it defaults to a WebAuthn stamper.
+
+### organizationId
+
+`string | undefined`
+
+Advanced. Overrides the sub-organization the SDK operates against.
+
+### proxyBaseUrl
+
+`string | undefined`
+
+Advanced. Base URL for a custom backend proxy in front of the ZeroDev wallet API.
+
+### aaUrl
+
+`string | undefined`
+
+Advanced. Overrides the account-abstraction bundler/paymaster URL.
+
+## React Native
+
+On React Native there are no platform defaults, so `rpId`, `apiKeyStamper`, and `sessionStorage` are **required** and configured through the adapters the SDK ships for Expo. See [React Native Configuration](/wallets/react-native/configuration).
diff --git a/docs/pages/wallets/hooks/use-authenticators.mdx b/docs/pages/wallets/hooks/use-authenticators.mdx
new file mode 100644
index 0000000..7702f6a
--- /dev/null
+++ b/docs/pages/wallets/hooks/use-authenticators.mdx
@@ -0,0 +1,87 @@
+import QueryResult from '../shared/query-result.mdx'
+
+# useAuthenticators [Hook for getting the authenticated user's linked authenticators]
+
+:::danger[IMPORTANT]
+**USE FOR INTERNAL TESTING PURPOSES ONLY.** You may use these features solely for internal evaluation purposes on supported testnets. DO NOT use for production use or share with your users. Wallets created during this preview ("Alpha Wallets") will be discontinued. Any tokens remaining within Alpha Wallets will be permanently lost upon discontinuance. Any mainnet tokens sent to an Alpha Wallet will not be deposited and will be permanently lost when discontinued. We are unable to help recover any lost funds from Alpha Wallets. We provide all previews on an "as is" basis without warranty of any kind, and we may terminate or suspend the availability of any preview at any time.
+:::
+
+## Import
+
+```tsx
+import { useAuthenticators } from '@zerodev/wallet-react'
+```
+
+## Usage
+
+```tsx
+import { useAuthenticators } from '@zerodev/wallet-react'
+import { useAccount } from 'wagmi'
+
+function UserProfile() {
+  const { isConnected } = useAccount()
+  const { data, isLoading } = useAuthenticators()
+
+  if (!isConnected) return null
+  if (isLoading) return <p>Loading authenticators...</p>
+
+  const email = data?.emailContacts?.[0]?.email
+
+  return <p>Email: {email ?? 'Not available'}</p>
+}
+```
+
+## Parameters
+
+```tsx
+import { type Config } from 'wagmi'
+import { type UseQueryOptions } from '@tanstack/react-query'
+```
+
+### config
+
+`Config | undefined`
+
+Optional Wagmi config. If omitted, the hook uses the nearest Wagmi config from context.
+
+### query
+
+`Omit<UseQueryOptions<GetAuthenticatorsReturnType>, 'queryKey' | 'queryFn'> | undefined`
+
+Optional TanStack Query options for the authenticators query.
+
+## Return Types
+
+[TanStack Query docs](https://tanstack.com/query/v5/docs/react/reference/useQuery)
+
+### data
+
+`GetAuthenticatorsReturnType | undefined`
+
+The authenticated user's linked authenticators, grouped by type. The query requires an active ZeroDev wallet session.
+
+#### oauths
+
+`OAuthAuthenticator[] | null`
+
+OAuth identities linked to the user.
+
+#### passkeys
+
+`PasskeyAuthenticator[] | null`
+
+Passkey authenticators registered for the user.
+
+#### emailContacts
+
+`EmailContact[] | null`
+
+Email contacts associated with the user. This is where email OTP and Magic Link addresses appear.
+
+#### apiKeys
+
+`ApiKeyAuthenticator[] | null`
+
+API-key authenticators associated with the user.
+
+<QueryResult />
diff --git a/docs/pages/wallets/hooks/use-get-user-email.mdx b/docs/pages/wallets/hooks/use-get-user-email.mdx
deleted file mode 100644
index 6e92cc7..0000000
--- a/docs/pages/wallets/hooks/use-get-user-email.mdx
+++ /dev/null
@@ -1,56 +0,0 @@
-import QueryResult from '../shared/query-result.mdx'
-
-# useGetUserEmail [Hook for getting the authenticated user's email]
-
-:::danger[IMPORTANT]
-**USE FOR INTERNAL TESTING PURPOSES ONLY.** You may use these features solely for internal evaluation purposes on supported testnets. DO NOT use for production use or share with your users. Wallets created during this preview ("Alpha Wallets") will be discontinued. Any tokens remaining within Alpha Wallets will be permanently lost upon discontinuance. Any mainnet tokens sent to an Alpha Wallet will not be deposited and will be permanently lost when discontinued. We are unable to help recover any lost funds from Alpha Wallets. We provide all previews on an "as is" basis without warranty of any kind, and we may terminate or suspend the availability of any preview at any time.
-:::
-
-## Import
-
-```tsx
-import { useGetUserEmail } from '@zerodev/wallet-react'
-```
-
-## Usage
-
-```tsx
-import { useGetUserEmail } from '@zerodev/wallet-react'
-import { useAccount } from 'wagmi'
-
-function UserProfile() {
-  const { isConnected } = useAccount()
-  const { data: userEmail, isLoading } = useGetUserEmail({})
-
-  if (!isConnected) return null
-
-  if (isLoading) return <p>Loading email...</p>
-
-  return <p>Email: {userEmail?.email ?? 'Not available'}</p>
-}
-```
-
-## Parameters
-
-```tsx
-import { type UseGetUserEmailParameters } from '@zerodev/wallet-react'
-```
-
-This hook takes an empty object `{}` as its argument. No additional parameters are required.
-
-## Return Types
-
-### data
-
-`{ email: string } | undefined`
-
-- Defaults to `undefined`
-- The authenticated user's email address, if available.
-
-#### email
-
-`string`
-
-The user's email address. This is available when the user authenticated with Email OTP, Magic Link, or Google OAuth. It may not be available for passkey-only authentication.
-
-<QueryResult />
diff --git a/docs/pages/wallets/hooks/use-send-magic-link.mdx b/docs/pages/wallets/hooks/use-send-magic-link.mdx
index 1d2690b..6546230 100644
--- a/docs/pages/wallets/hooks/use-send-magic-link.mdx
+++ b/docs/pages/wallets/hooks/use-send-magic-link.mdx
@@ -36,8 +36,12 @@ function SendMagicLink() {
             email,
             redirectURL: `${window.location.origin}/verify`,
           })
-          // Store otpId for the verify page
+          // Store both values for the verify page
           sessionStorage.setItem('magicLinkOtpId', result.otpId)
+          sessionStorage.setItem(
+            'magicLinkOtpEncryptionTargetBundle',
+            result.otpEncryptionTargetBundle,
+          )
         }}
         disabled={sendMagicLink.isPending || !email}
       >
@@ -66,21 +70,27 @@ function SendMagicLink() {
 
 ### otpCodeCustomization
 
-`{ length?: 6 | 7 | 8 | 9; alphanumeric?: boolean } | undefined`
+`{ length: 6 | 7 | 8 | 9; alphanumeric: boolean } | undefined`
 
 Optional customization for the generated verification code.
 
 #### length
 
-`6 | 7 | 8 | 9 | undefined`
+`6 | 7 | 8 | 9`
 
-The number of characters in the code. Defaults to `6`.
+The number of characters in the code.
 
 #### alphanumeric
 
-`boolean | undefined`
+`boolean`
 
-Whether to use alphanumeric characters instead of digits only. Defaults to `false`.
+Whether to use alphanumeric characters instead of digits only.
+
+### connector
+
+`Connector | undefined`
+
+Optional Wagmi connector to send the magic link with. If omitted, the hook uses the configured ZeroDev connector.
 
 ## Return Types
 
@@ -88,19 +98,19 @@ Whether to use alphanumeric characters instead of digits only. Defaults to `fals
 
 ### mutate
 
-`(variables: { email: string; redirectURL: string }) => void`
+`(variables: { email: string; redirectURL: string; otpCodeCustomization?: { length: 6 | 7 | 8 | 9; alphanumeric: boolean }; connector?: Connector }) => void`
 
 The mutation function to send the magic link.
 
 ### mutateAsync
 
-`(variables: { email: string; redirectURL: string }) => Promise<{ otpId: string }>`
+`(variables: { email: string; redirectURL: string; otpCodeCustomization?: { length: 6 | 7 | 8 | 9; alphanumeric: boolean }; connector?: Connector }) => Promise<{ otpId: string; otpEncryptionTargetBundle: string }>`
 
 Similar to [`mutate`](#mutate) but returns a promise.
 
 ### data
 
-`{ otpId: string } | undefined`
+`{ otpId: string; otpEncryptionTargetBundle: string } | undefined`
 
 - Defaults to `undefined`
 - The data returned from the mutation on success.
@@ -111,4 +121,10 @@ Similar to [`mutate`](#mutate) but returns a promise.
 
 The identifier for this magic link verification. Store this value and pass it to [`useVerifyMagicLink`](/wallets/hooks/use-verify-magic-link) on the redirect page.
 
+#### otpEncryptionTargetBundle
+
+`string`
+
+The encrypted OTP target bundle for this verification. Store it with `otpId` and pass both values to [`useVerifyMagicLink`](/wallets/hooks/use-verify-magic-link) on the redirect page.
+
 <MutationResult />
diff --git a/docs/pages/wallets/hooks/use-send-otp.mdx b/docs/pages/wallets/hooks/use-send-otp.mdx
index ffb2fb1..1f84888 100644
--- a/docs/pages/wallets/hooks/use-send-otp.mdx
+++ b/docs/pages/wallets/hooks/use-send-otp.mdx
@@ -34,7 +34,8 @@ function SendCode() {
         onClick={async () => {
           const result = await sendOTP.mutateAsync({ email })
           console.log('OTP ID:', result.otpId)
-          // Pass otpId to useVerifyOTP
+          // Store result.otpId and result.otpEncryptionTargetBundle,
+          // then pass both to useVerifyOTP
         }}
         disabled={sendOTP.isPending || !email}
       >
@@ -67,21 +68,27 @@ Custom template for the email content.
 
 ### otpCodeCustomization
 
-`{ length?: 6 | 7 | 8 | 9; alphanumeric?: boolean } | undefined`
+`{ length: 6 | 7 | 8 | 9; alphanumeric: boolean } | undefined`
 
 Optional customization for the generated OTP code.
 
 #### length
 
-`6 | 7 | 8 | 9 | undefined`
+`6 | 7 | 8 | 9`
 
-The number of characters in the OTP code. Defaults to `6`.
+The number of characters in the OTP code.
 
 #### alphanumeric
 
-`boolean | undefined`
+`boolean`
 
-Whether to use alphanumeric characters instead of digits only. Defaults to `false`.
+Whether to use alphanumeric characters instead of digits only.
+
+### connector
+
+`Connector | undefined`
+
+Optional Wagmi connector to send the OTP with. If omitted, the hook uses the configured ZeroDev connector.
 
 ## Return Types
 
@@ -89,19 +96,19 @@ Whether to use alphanumeric characters instead of digits only. Defaults to `fals
 
 ### mutate
 
-`(variables: { email: string; emailCustomization?: { magicLinkTemplate?: string } }) => void`
+`(variables: { email: string; emailCustomization?: { magicLinkTemplate?: string }; otpCodeCustomization?: { length: 6 | 7 | 8 | 9; alphanumeric: boolean }; connector?: Connector }) => void`
 
 The mutation function to send the OTP.
 
 ### mutateAsync
 
-`(variables: { email: string; emailCustomization?: { magicLinkTemplate?: string } }) => Promise<{ otpId: string }>`
+`(variables: { email: string; emailCustomization?: { magicLinkTemplate?: string }; otpCodeCustomization?: { length: 6 | 7 | 8 | 9; alphanumeric: boolean }; connector?: Connector }) => Promise<{ otpId: string; otpEncryptionTargetBundle: string }>`
 
 Similar to [`mutate`](#mutate) but returns a promise.
 
 ### data
 
-`{ otpId: string } | undefined`
+`{ otpId: string; otpEncryptionTargetBundle: string } | undefined`
 
 - Defaults to `undefined`
 - The data returned from the mutation on success.
@@ -112,4 +119,10 @@ Similar to [`mutate`](#mutate) but returns a promise.
 
 The identifier for this OTP verification attempt. Pass this to [`useVerifyOTP`](/wallets/hooks/use-verify-otp) to complete authentication.
 
+#### otpEncryptionTargetBundle
+
+`string`
+
+The encrypted OTP target bundle for this verification attempt. Store it with `otpId` and pass both values to [`useVerifyOTP`](/wallets/hooks/use-verify-otp).
+
 <MutationResult />
diff --git a/docs/pages/wallets/hooks/use-verify-magic-link.mdx b/docs/pages/wallets/hooks/use-verify-magic-link.mdx
index 5810d1b..c5015ed 100644
--- a/docs/pages/wallets/hooks/use-verify-magic-link.mdx
+++ b/docs/pages/wallets/hooks/use-verify-magic-link.mdx
@@ -28,9 +28,12 @@ function VerifyPage() {
   useEffect(() => {
     const code = searchParams.get('code')
     const otpId = sessionStorage.getItem('magicLinkOtpId')
+    const otpEncryptionTargetBundle = sessionStorage.getItem(
+      'magicLinkOtpEncryptionTargetBundle',
+    )
 
-    if (code && otpId && !isConnected) {
-      verifyMagicLink.mutateAsync({ otpId, code })
+    if (code && otpId && otpEncryptionTargetBundle && !isConnected) {
+      verifyMagicLink.mutateAsync({ otpId, code, otpEncryptionTargetBundle })
     }
   }, [searchParams])
 
@@ -56,19 +59,31 @@ function VerifyPage() {
 
 **Required.** The verification code from the magic link URL query parameters.
 
+### otpEncryptionTargetBundle
+
+`string`
+
+**Required.** The encrypted OTP target bundle returned by [`useSendMagicLink`](/wallets/hooks/use-send-magic-link). Store it with `otpId` and pass it verbatim to the verify step.
+
+### connector
+
+`Connector | undefined`
+
+Optional Wagmi connector to verify the magic link with. If omitted, the hook uses the configured ZeroDev connector.
+
 ## Return Types
 
 [TanStack Query mutation docs](https://tanstack.com/query/v5/docs/react/reference/useMutation)
 
 ### mutate
 
-`(variables: { otpId: string; code: string }) => void`
+`(variables: { otpId: string; code: string; otpEncryptionTargetBundle: string; connector?: Connector }) => void`
 
 The mutation function to verify the magic link.
 
 ### mutateAsync
 
-`(variables: { otpId: string; code: string }) => Promise<void>`
+`(variables: { otpId: string; code: string; otpEncryptionTargetBundle: string; connector?: Connector }) => Promise<void>`
 
 Similar to [`mutate`](#mutate) but returns a promise. Resolves when the magic link is verified and the wallet is connected.
 
diff --git a/docs/pages/wallets/hooks/use-verify-otp.mdx b/docs/pages/wallets/hooks/use-verify-otp.mdx
index 4ee8832..2e5aaf7 100644
--- a/docs/pages/wallets/hooks/use-verify-otp.mdx
+++ b/docs/pages/wallets/hooks/use-verify-otp.mdx
@@ -19,7 +19,13 @@ import { useState } from 'react'
 import { useVerifyOTP } from '@zerodev/wallet-react'
 import { useAccount } from 'wagmi'
 
-function VerifyCode({ otpId }: { otpId: string }) {
+function VerifyCode({
+  otpId,
+  otpEncryptionTargetBundle,
+}: {
+  otpId: string
+  otpEncryptionTargetBundle: string
+}) {
   const [code, setCode] = useState('')
   const verifyOTP = useVerifyOTP()
   const { address, isConnected } = useAccount()
@@ -37,7 +43,9 @@ function VerifyCode({ otpId }: { otpId: string }) {
         placeholder="Enter verification code"
       />
       <button
-        onClick={() => verifyOTP.mutateAsync({ code, otpId })}
+        onClick={() =>
+          verifyOTP.mutateAsync({ code, otpId, otpEncryptionTargetBundle })
+        }
         disabled={verifyOTP.isPending || !code}
       >
         {verifyOTP.isPending ? 'Verifying...' : 'Verify'}
@@ -62,19 +70,31 @@ function VerifyCode({ otpId }: { otpId: string }) {
 
 **Required.** The OTP identifier returned by [`useSendOTP`](/wallets/hooks/use-send-otp).
 
+### otpEncryptionTargetBundle
+
+`string`
+
+**Required.** The encrypted OTP target bundle returned by [`useSendOTP`](/wallets/hooks/use-send-otp). Pass it verbatim to the verify step.
+
+### connector
+
+`Connector | undefined`
+
+Optional Wagmi connector to verify the OTP with. If omitted, the hook uses the configured ZeroDev connector.
+
 ## Return Types
 
 [TanStack Query mutation docs](https://tanstack.com/query/v5/docs/react/reference/useMutation)
 
 ### mutate
 
-`(variables: { code: string; otpId: string }) => void`
+`(variables: { code: string; otpId: string; otpEncryptionTargetBundle: string; connector?: Connector }) => void`
 
 The mutation function to verify the OTP.
 
 ### mutateAsync
 
-`(variables: { code: string; otpId: string }) => Promise<void>`
+`(variables: { code: string; otpId: string; otpEncryptionTargetBundle: string; connector?: Connector }) => Promise<void>`
 
 Similar to [`mutate`](#mutate) but returns a promise. Resolves when the code is verified and the wallet is connected.
 
diff --git a/docs/pages/wallets/quickstart.mdx b/docs/pages/wallets/quickstart.mdx
index ca7e032..1a51375 100644
--- a/docs/pages/wallets/quickstart.mdx
+++ b/docs/pages/wallets/quickstart.mdx
@@ -55,6 +55,8 @@ export const config = createConfig({
 
 Get your project ID from the [ZeroDev Dashboard](https://dashboard.zerodev.app/).
 
+The `mode` option defaults to `'7702'`; set it to `'4337'` for a counterfactual ERC-4337 smart account or `'EOA'` for a plain EOA wallet. See [Connector Options](/wallets/connector-options) for the full list of options.
+
 ## 2. Wrap your app
 
 Wrap your application with `WagmiProvider` and `QueryClientProvider`:
diff --git a/docs/pages/wallets/session-management.mdx b/docs/pages/wallets/session-management.mdx
index 34c02ff..208ab51 100644
--- a/docs/pages/wallets/session-management.mdx
+++ b/docs/pages/wallets/session-management.mdx
@@ -76,7 +76,7 @@ zeroDevWallet({
 })
 ```
 
-This is useful for React Native apps where `localStorage` is not available.
+This is useful for React Native apps where `localStorage` is not available — see [React Native Configuration](/wallets/react-native/configuration) for the storage adapters the SDK ships for Expo.
 
 ## Detecting session expiry
 
diff --git a/vocs.config.tsx b/vocs.config.tsx
index f7d1b16..f7e634f 100644
--- a/vocs.config.tsx
+++ b/vocs.config.tsx
@@ -680,6 +680,10 @@ export default defineConfig({
                 text: "Export Wallet",
                 link: "/wallets/react-native/export-wallet",
               },
+              {
+                text: "React Native Web",
+                link: "/wallets/react-native/web",
+              },
             ],
           },
           {
@@ -716,6 +720,10 @@ export default defineConfig({
                 text: "Export Wallet",
                 link: "/wallets/export",
               },
+              {
+                text: "Connector Options",
+                link: "/wallets/connector-options",
+              },
             ],
           },
           {
@@ -769,8 +777,8 @@ export default defineConfig({
                 link: "/wallets/hooks/use-verify-magic-link",
               },
               {
-                text: "useGetUserEmail",
-                link: "/wallets/hooks/use-get-user-email",
+                text: "useAuthenticators",
+                link: "/wallets/hooks/use-authenticators",
               },
               {
                 text: "useRefreshSession",