Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

mode

Authentication mode that determines where passkey operations occur.

Type: Mode.CrossPlatform | Mode.AppSpecific Default: Mode.CrossPlatform

Mode Comparison

FeatureCrossPlatformAppSpecific
Passkey operationsOn keys.jaw.id (popup)Within your dApp
User experienceRedirects to popupStays in your app
Wallet reuseUniversalApp-specific only
Origin bindingkeys.jaw.idYour domain
BrandingJAW interfaceCustom UI supported

Choosing a Mode

Use CrossPlatform (Default) when:

  • You want users to reuse their wallet across multiple dApps
  • You prefer a consistent, maintained authentication UI
  • Quick integration is a priority

Use AppSpecific when:

  • You want users to stay entirely within your application
  • You need full control over the UI/UX
  • You're building a white-label experience
  • Wallet portability across apps is not needed

Related