Repository navigation
feat: support the use-wallet passkey wallet - #85
Merged
Merged
Conversation
Apps that register passkey() from @txnlab/use-wallet-passkey (use-wallet 5.2+) now get it in the connect dialog with "Create passkey" and "Sign in" buttons. Passkey errors keep the dialog open with a message the user can act on (cancelled or no passkey found, in-app browser, no PRF support). The connect call starts before any await, so Safari and iOS keep the tap. A new ./plugins/passkey entry (React and Vue) adds to the connected menu: - Export Recovery Phrase: a fresh passkey prompt, Falcon / quantum import instructions for Lute and Pera, a 60s timeout, and best-effort clipboard clearing - Session lock status with Unlock and Lock (session: true) - A note that the account belongs to the site (disclosure, on by default) Only the plugin entry imports useWalletManager (use-wallet 5.2+), so the main entry keeps the ^4.6.0 || ^5.0.0 peer range. The adapter is typed structurally, with a type test against PasskeyAdapter; use-wallet-passkey is a devDependency only. Also: - Bump use-wallet devDependencies and examples to 5.2.0 - Add react-passkey and vue-passkey examples (passkey, Lute, Pera) - Add passkey-react and passkey-vue Playwright projects using Chromium's virtual authenticator with PRF, and run them in CI - Document the plugin and the WalletList args contract
The connect dialog now leads with the passkey wallet: a full-width "Continue with passkey" button signs in, and a "New here? Create a passkey" link creates one. The other wallets follow under an "or connect a wallet" divider. WalletList no longer renders the passkey wallet; the section is exported as PasskeyConnect for custom connect menus. The connected menu tags a passkey account with its domain. The plugin's disclosure is now off by default; with `disclosure: true` it shows until the user chooses "Got it", remembered per address in localStorage (with an in-memory fallback when storage is unavailable). Export Recovery Phrase uses a document icon, since a key now means passkey sign-in. Also restore the passkey plugin's Requirements and Subpath Import docs, which the first passkey commit dropped from PLUGINS.md.
vite-plugin-node-polyfills injects its shim imports into every module, including the workspace-linked packages/*/dist files. Those can't resolve vite-plugin-node-polyfills, so `pnpm build:examples` failed for the react, react-css-only, react-custom, react-web3auth and vue examples. CI doesn't build the examples, so this went unnoticed. Alias the three shims to their ESM files, resolved from each example. All polyfills stay on (Web3Auth still gets its `process` global), and the passkey examples drop their Buffer-only workaround for the same fix.
Connect dialogs can now present the passkey wallet two ways: - 'featured' (default): the existing "Continue with passkey" button and "Create a passkey" link, with the other wallets below - 'list': "Sign in with passkey" and "Create a passkey" rows in a Passkey group above a Wallets group, for apps where most users bring a wallet Set it app-wide with `passkeyLayout` on WalletUIProvider, or per menu on WalletButton or ConnectWalletMenu; the menu prop wins, and the default is 'featured'. PasskeyConnect takes a `layout` prop so custom menus get both, and PasskeyConnectLayout is exported. The wallet icon tile moves into a shared WalletIcon component. The passkey examples get a Featured / List selector (or ?layout=list), and e2e covers the list layout's rows, create and sign-in, the error hint, and switching layouts through the provider.
The connect dialog now shows the passkey wallet as "Sign in with passkey" and "Create a passkey" rows in a Passkey group above the other wallets. `passkeyLayout: 'featured'` keeps the "Continue with passkey" layout. PasskeyConnect defaults to 'list' as well. The dialog now passes `layout="featured"` to PasskeyConnect explicitly instead of relying on its default, which had shown the list rows for 'featured' once the default changed. The passkey examples start in the list layout (?layout=featured opens the other), and the e2e suites set their layout explicitly.
While a passkey prompt is open, the control the user pressed shows a
spinner and "Waiting for your passkey…" at full strength, and the other
control dims. Both layouts do this; the status line is now for screen
readers only. PasskeyConnectStatus gains an optional `action`
('sign-in' | 'create') to tell them apart.
The plugin's recovery item is now "Back up account" with a numbered-list
icon, tagged "Not backed up" until the phrase has been revealed once for
the account (remembered per address in localStorage, with an in-memory
fallback). `recoveryPhrase: { backupReminder: false }` turns the tag off.
The per-address storage for the disclosure and this flag now share one
helper (storage.ts).
The passkey e2e fixture can turn off presence simulation to hold a prompt
open, so the pending state is tested in both layouts. The examples' intro
copy now matches the list default.
The tag could only record that the recovery phrase had been shown, not that the user backed it up, so it claimed more than the app can know. Drop it along with the `recoveryPhrase.backupReminder` option and its per-address storage flag. The menu item keeps its "Back up account" label.
A solid shield (Heroicons shield-check without the check) reads as a protective step without implying the backup is already done. A key would read as passkey sign-in.
txnlab-release-bot Bot
added a commit
that referenced
this pull request
Nov 8, 2026
# [1.4.0](v1.3.0...v1.4.0) (2026-11-08) ### Features * support the use-wallet passkey wallet ([#85](#85)) ([c2734e7](c2734e7))
Contributor
|
🎉 This PR is included in version 1.4.0 🎉 The release is available on: Your semantic-release bot 📦🚀 |
drichar
added a commit
that referenced
this pull request
Nov 8, 2026
Vue is published by the manual Release Vue workflow, which publishes the version in packages/vue/package.json. 1.2.0 carries the passkey support from #85.
drichar
added a commit
that referenced
this pull request
Nov 8, 2026
Vue is published by the manual Release Vue workflow, which publishes the version in packages/vue/package.json. 1.2.0 carries the passkey support from #85.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds support for the passkey wallet in use-wallet 5.2.0 (
@txnlab/use-wallet-passkey) to both@txnlab/use-wallet-ui-reactand@txnlab/use-wallet-ui-vue.passkey(), the connect dialog shows a Passkey group with Sign in with passkey and Create a passkey above the other wallets.passkeyLayout: 'featured'leads with a Continue with passkey button instead../plugins/passkeyentry adds Back up account (Falcon / quantum recovery-phrase export), session Lock and Unlock, and an optional show-once note that the account belongs to this site.^4.6.0 || ^5.0.0peer range. The plugin needs use-wallet 5.2+, which any app with the passkey wallet already has.Details
Compatibility
wallet.connect(args), which v4.6+ already has../plugins/passkeyimportsuseWalletManager(), which React and Vue added in 5.2.@txnlab/use-wallet-passkeypeers on core^5.2.0, and each framework adapter pins its core version, so an app with the passkey wallet always has it.@txnlab/use-wallet-passkey. A type test fails ifPasskeyAdapterstops matching.Safari / iOS
connect,unlockorexportRecoveryPhrasebefore anyawait, so the browser keeps the user's tap.Connect dialog
passkeyLayoutcan be set onWalletUIProvider, or per menu onWalletButtonandConnectWalletMenu. The menu setting wins; the default is'list'.PasskeyConnectis exported for custom menus.WalletListno longer renders the passkey wallet.Connected menu
localhost.passkeyPlugin()session: true: Locked or Unlocked status with Unlock and Lock.disclosure: true: a note shown until "Got it", remembered per address inlocalStorage, with an in-memory fallback.Examples and tests
examples/react-passkeyandexamples/vue-passkeyapps (passkey, Lute, Pera) with a layout selector.passkey-reactandpasskey-vuePlaywright projects use the CDP virtual authenticator with PRF. They cover create, sign in, errors, the pending state, both layouts, session, recovery phrase, clipboard clearing, and dismissal, including when storage is blocked. CI now runs them.Also fixed
pnpm build:examplesfailed onmainfor five examples:vite-plugin-node-polyfillsinjected shim imports into the workspace-linkeddistfiles. The examples now alias the shims, and every polyfill stays on.