Overview
WebAuthn passkeys replace PINs with biometric authentication (Face ID, Touch ID, Windows Hello). No PINs to remember or store.Prerequisites
- Next.js 13+ with App Router
- Modern browser with WebAuthn support
- Biometric hardware (fingerprint, face recognition)
- Chipi Next.js SDK installed
Installation
Basic Implementation
1
Create wallet with passkey
2
Authenticate with passkey
3
Migrate existing wallet (optional)
If users already have a PIN-based wallet, they can migrate to passkey:
Example
- Create Wallet
- Transfer with Passkey
- Migrate to Passkey
Hooks Reference
Browser Support
- ✅ Chrome 67+ (Desktop & Android)
- ✅ Safari 14+ (iOS 14+, macOS)
- ✅ Firefox 60+ (Desktop)
- ✅ Edge 18+ (Desktop)
Passkeys are stored in the browser and synced via platform (iCloud Keychain, Google Password Manager).
Security Benefits
- No PINs stored - Keys derived on-demand from biometric
- Platform-level security - Hardware-backed authentication
- Phishing resistant - Domain-bound credentials
- User convenience - One tap authentication
Next Steps
- Check out useCreateWallet for wallet creation options
- Learn about useTransfer for token transfers
- Explore session keys for additional security
