React Native Secure Storage
Secure wallet credential storage for React Native apps
React Native Secure Storage provides a typed wrapper for storing encrypted wallet seed material and encryption keys with react-native-keychain. It is designed for React Native wallet apps that need app-scoped encrypted storage with optional biometric access.
Powered by @tetherto/wdk-react-native-secure-storage.
Features
- Wallet credential helpers: Store and retrieve encrypted seeds, encrypted entropy, and encryption keys.
- Per-wallet identifiers: Pass an optional
identifierto isolate storage keys for multiple wallets. - Biometric access: Require biometric authentication for encryption key reads with
requireBiometrics. - Device security checks: Check whether device passcode, PIN, pattern, or biometrics are enabled before sensitive flows.
- Typed errors: Catch validation, authentication, timeout, keychain read, and keychain write failures.
When to use it
Use this package for local encrypted storage in React Native wallet apps. It does not generate wallet seeds, encrypt plaintext seed material by itself, or provide cloud backup. Pair it with WDK wallet modules and a backup provider when you need recovery across devices.
Configuration
Install dependencies, configure authentication prompts, and create a storage instance.
API Reference
Review createSecureStorage, storage methods, options, constants, and errors.