Update wallet docs by srinjoyc · Pull Request #76 · zerodevapp/docs

srinjoyc · 2026-07-01T23:27:14Z

Summary

Rewrite the Wallet quickstart and authentication docs around the tested SDK integration flow.
Add Wallet UI Kit and SDK Reference pages, and update Wallet navigation.
Move auth-page next steps toward signing, sending transactions, and alternative login methods.

vercel · 2026-07-01T23:27:20Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview, Comment	Jul 2, 2026 6:45pm

Restructure the wallets intro around GTM positioning and competitor best practices: smart-account-first lead, how-it-works flow with key security, capabilities, "Why ZeroDev Wallet" value props with a roadmap subsection, first-party SDK framing, and a pricing section. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Drop the standalone wallet SDK reference from the sidebar and delete the page; nothing else links to it. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Drop the subtitle, frame the kit as drop-in UI for faster time to market with flexible adoption, note upcoming screens (transaction confirmation, portfolio, history, balances), and inline the custom-UI auth links. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

# Conflicts: # docs/pages/wallets/auth/passkeys.mdx # docs/pages/wallets/auth/wallet-ui-kit.mdx # docs/pages/wallets/quickstart.mdx # docs/pages/wallets/session-management.mdx

brtkx · 2026-07-02T13:38:52Z

+The Wallet UI Kit gives you prebuilt React UI for ZeroDev Wallet. Use it when you want to get started faster with a ready-made login flow instead of building every authentication screen yourself.
+
+The kit uses a Wagmi-compatible ZeroDev connector, so after the user signs in you can use standard Wagmi hooks such as `useAccount`, `useSignMessage`, and `useSendTransaction`.
+


"The current kit covers login and an experimental confirmation screen for signature signing and transaction confirmations that is currently in beta." - wasn't signing out of scope in general? We assumed it won't be part of this version of the package at all.

Agreed, removing and will put in "coming soon"

brtkx · 2026-07-02T13:40:06Z

+
+The current kit covers login and an experimental confirmation screen for signature signing and transaction confirmations that is currently in beta. This confirmation UI will improve over time. More wallet UI components are coming, including onramps, asset management and portfolio views, transaction history, and chain-abstracted balances.
+
+For a fully custom UI, use the hook-based authentication pages instead: [Passkeys](/wallets/auth/passkeys), [Email OTP](/wallets/auth/email-otp), [Magic Link](/wallets/auth/magic-link), or [Google OAuth](/wallets/auth/google-oauth).


For fully custom UI, they can also use https://github.com/zerodevapp/zerodev-wallet-sdk/blob/main/packages/react-wallet-ui/src/auth/hooks/useAuth.ts

Ty, will upddate

brtkx · 2026-07-02T13:43:36Z

+:::code-group
+
+```bash [npm]
+npm i @zerodev/react-wallet-ui @zerodev/wallet-react @zerodev/wallet-core wagmi viem @tanstack/react-query


npm i @zerodev/react-wallet-ui @zerodev/wallet-core @zerodev/wallet-react wagmi viem @wagmi/core @tanstack/react-query zustand

Needs to be adjusted for all install examples

brtkx · 2026-07-02T13:44:04Z

+```
+
+```bash [pnpm]
+pnpm i @zerodev/react-wallet-ui @zerodev/wallet-react @zerodev/wallet-core wagmi viem @tanstack/react-query


nit: pnpm i works but pnpm add is the correct idiomatic command here

brtkx · 2026-07-02T13:49:37Z

+
+## Size the container
+
+`AuthFlow` renders into the space you give it. Put it in a constrained wallet-sized container, modal, or drawer instead of letting it stretch across the full page on large screens.


Currently this is incorrect. AuthFlow has fixed size based on the designs, and no wrapper is going to modify it.

brtkx · 2026-07-02T13:50:17Z

+</div>
+```
+
+The `onClose` prop is optional. Use it when your app owns surrounding UI state, such as closing a modal after the user clicks the kit's close button.


This is not the current behavior but I remember you asked us to add it. We will adjust on our end.

ty let me know if this changes will leave for now.

andrascodes · 2026-07-02T14:42:14Z

@@ -2,10 +2,6 @@ import QueryResult from '../shared/query-result.mdx'

 # useGetUserEmail [Hook for getting the authenticated user's email]


@SahilVasava is this file still relevant? This hook doesn't exist anymore does it?

We also have a useAuthenticators now. Should that be documented?

That's right. useGetUserEmail deprecated. useAuthenticators should be documented now

@srinjoyc I'll add that on my PR and you can modify it later

…serEmail refs, align magic-link keys

…ct-ui

SahilVasava · 2026-07-02T15:53:49Z

@srinjoyc one item from reviewing this PR that needs a decision rather than a mechanical edit:

Orphaned hook reference pages. vocs.config.tsx removes the entire "Hooks" sidebar section, but the hook reference pages still exist as files (use-register-passkey, use-login-passkey, use-authenticate-oauth, use-send-otp, use-verify-otp, use-refresh-session, use-export-wallet, use-export-private-key, use-get-user-email). The auth guides also dropped their ## Hooks link lists, so most of these are now built but unreachable from the sidebar and largely unlinked from prose. Either delete the ones you don't want, or keep a Hooks/Reference group in the nav. (Overlaps with @andrascodes adding a useAuthenticators page.)

The small mechanical fixes I found (stale emailCustomization, deprecated useGetUserEmail inline links, magic-link sessionStorage keys, and the @zerodev/react-wallet-ui → @zerodev/wallet-react-ui rename) are in #78, stacked on this branch.

docs(wallets): fix stale OTP params, deprecated useGetUserEmail refs, magic-link keys

…native-focused-documentation docs(wallets): add React Native focused documentation

srinjoyc · 2026-07-02T17:54:43Z

@srinjoyc one item from reviewing this PR that needs a decision rather than a mechanical edit:

Orphaned hook reference pages. vocs.config.tsx removes the entire "Hooks" sidebar section, but the hook reference pages still exist as files (use-register-passkey, use-login-passkey, use-authenticate-oauth, use-send-otp, use-verify-otp, use-refresh-session, use-export-wallet, use-export-private-key, use-get-user-email). The auth guides also dropped their ## Hooks link lists, so most of these are now built but unreachable from the sidebar and largely unlinked from prose. Either delete the ones you don't want, or keep a Hooks/Reference group in the nav. (Overlaps with @andrascodes adding a useAuthenticators page.)

The small mechanical fixes I found (stale emailCustomization, deprecated useGetUserEmail inline links, magic-link sessionStorage keys, and the @zerodev/react-wallet-ui → @zerodev/wallet-react-ui rename) are in #78, stacked on this branch.

Going to delete the references and will be incrporated into specific contexual pages in the "Authentication" and "Wallet API" sections.

brtkx · 2026-07-02T18:20:02Z

+
+A magic link needs a verified `https` callback — an **App Link** on Android, a **Universal Link** on iOS — so that tapping the link in the email opens the app. Email clients (e.g. Gmail) don't render custom-scheme links, so a plain `https` link on your verified domain is required.
+
+The flow: send → the backend emails `${redirectURL}?code=<otp>` → the user taps it → the app opens at `/verify-email` → the route pairs the `code` from the URL with the persisted `otpId`/`otpEncryptionTargetBundle` and verifies.


We have dropped redirectURL, is it correctly mentioned here?

brtkx · 2026-07-02T18:20:35Z

+        disabled={send.isPending || !email}
+        onPress={() =>
+          send.mutate(
+            { email, redirectURL: `https://${RP_ID}/verify-email` },


Same here, should redirectURL be dropped?

Correct, updating all these

srinjoyc added 2 commits July 1, 2026 13:48

Expose wallet docs in navigation

f4b3685

Update wallet docs

0f14e9b

vercel Bot deployed to Preview July 1, 2026 23:28 View deployment

Verify wallet docs snippets

6fddc46

vercel Bot deployed to Preview July 2, 2026 00:28 View deployment

srinjoyc and others added 2 commits July 2, 2026 05:25

docs(wallets): remove SDK Reference page and nav entry

f44c193

Drop the standalone wallet SDK reference from the sidebar and delete the page; nothing else links to it. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

vercel Bot deployed to Preview July 2, 2026 12:29 View deployment

vercel Bot deployed to Preview July 2, 2026 12:42 View deployment

Refine wallet docs tone and examples

902e04a

srinjoyc marked this pull request as ready for review July 2, 2026 12:58

srinjoyc requested review from SahilVasava and brtkx July 2, 2026 12:58

vercel Bot deployed to Preview July 2, 2026 12:59 View deployment

Update wallet docs for AA host config

a4de559

vercel Bot deployed to Preview July 2, 2026 13:17 View deployment

docs(wallets): replace aaUrl with aaHost (host-only, multichain-safe)

f5948fd

SahilVasava mentioned this pull request Jul 2, 2026

docs(wallets): replace aaUrl with aaHost #77

Merged

Update wallet UI package name

3da4ab0

vercel Bot deployed to Preview July 2, 2026 13:25 View deployment

Merge branch 'pr-77' into srinjoy/update-wallet-docs

1aec5e5

# Conflicts: # docs/pages/wallets/auth/passkeys.mdx # docs/pages/wallets/auth/wallet-ui-kit.mdx # docs/pages/wallets/quickstart.mdx # docs/pages/wallets/session-management.mdx

vercel Bot deployed to Preview July 2, 2026 13:33 View deployment

brtkx reviewed Jul 2, 2026

View reviewed changes

andrascodes reviewed Jul 2, 2026

View reviewed changes

docs(wallets): drop removed OTP customization, fix deprecated useGetU…

666c957

…serEmail refs, align magic-link keys

SahilVasava mentioned this pull request Jul 2, 2026

docs(wallets): fix stale OTP params, deprecated useGetUserEmail refs, magic-link keys #78

Merged

docs(wallets): rename @zerodev/react-wallet-ui to @zerodev/wallet-rea…

4a7041b

…ct-ui

Merge pull request #78 from zerodevapp/sahil/docs-wallet-fixes

2980320

docs(wallets): fix stale OTP params, deprecated useGetUserEmail refs, magic-link keys

vercel Bot deployed to Preview July 2, 2026 15:57 View deployment

andrascodes and others added 7 commits July 2, 2026 18:07

docs(wallets): add React Native focused documentation

e20b768

docs(wallets): update web documentation

389d53f

docs(wallets): add guide for react-native-web

c3cb3e1

docs(wallets): improve react-native-web page

6947100

docs(wallets): add steps to make iOS work

8b16a14

Merge pull request #65 from zerodevapp/andras/docs-wallets-add-react-…

db434b1

…native-focused-documentation docs(wallets): add React Native focused documentation

Update wallet docs for latest SDK feedback

aa74745

vercel Bot deployed to Preview July 2, 2026 16:19 View deployment

srinjoyc added 2 commits July 2, 2026 09:32

Merge latest wallet docs updates

30f9d35

Clean up wallet sidebar references

70fd966

vercel Bot deployed to Preview July 2, 2026 16:47 View deployment

Consolidate wallet signing docs

46260b2

vercel Bot deployed to Preview July 2, 2026 17:01 View deployment

Restore wallet API reference links

106f4da

vercel Bot deployed to Preview July 2, 2026 17:14 View deployment

Remove unsupported Solana export references

c4dd520

vercel Bot deployed to Preview July 2, 2026 17:20 View deployment

Audit wallet docs against latest SDK

949f468

vercel Bot deployed to Preview July 2, 2026 17:44 View deployment

Clarify smart wallet intro

bf6e15e

vercel Bot deployed to Preview July 2, 2026 17:54 View deployment

brtkx reviewed Jul 2, 2026

View reviewed changes

Address wallet docs review feedback

af746df

vercel Bot deployed to Preview July 2, 2026 18:45 View deployment

		The Wallet UI Kit gives you prebuilt React UI for ZeroDev Wallet. Use it when you want to get started faster with a ready-made login flow instead of building every authentication screen yourself.

		The kit uses a Wagmi-compatible ZeroDev connector, so after the user signs in you can use standard Wagmi hooks such as `useAccount`, `useSignMessage`, and `useSendTransaction`.


		The current kit covers login and an experimental confirmation screen for signature signing and transaction confirmations that is currently in beta. This confirmation UI will improve over time. More wallet UI components are coming, including onramps, asset management and portfolio views, transaction history, and chain-abstracted balances.

		For a fully custom UI, use the hook-based authentication pages instead: [Passkeys](/wallets/auth/passkeys), [Email OTP](/wallets/auth/email-otp), [Magic Link](/wallets/auth/magic-link), or [Google OAuth](/wallets/auth/google-oauth).


		## Size the container

		`AuthFlow` renders into the space you give it. Put it in a constrained wallet-sized container, modal, or drawer instead of letting it stretch across the full page on large screens.

		@@ -2,10 +2,6 @@ import QueryResult from '../shared/query-result.mdx'

		# useGetUserEmail [Hook for getting the authenticated user's email]


		A magic link needs a verified `https` callback — an App Link on Android, a Universal Link on iOS — so that tapping the link in the email opens the app. Email clients (e.g. Gmail) don't render custom-scheme links, so a plain `https` link on your verified domain is required.

		The flow: send → the backend emails `${redirectURL}?code=<otp>` → the user taps it → the app opens at `/verify-email` → the route pairs the `code` from the URL with the persisted `otpId`/`otpEncryptionTargetBundle` and verifies.

Uh oh!

Conversation

srinjoyc commented Jul 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Uh oh!

vercel Bot commented Jul 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

SahilVasava commented Jul 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

srinjoyc commented Jul 2, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

srinjoyc commented Jul 1, 2026 •

edited

Loading

vercel Bot commented Jul 1, 2026 •

edited

Loading

SahilVasava commented Jul 2, 2026 •

edited

Loading