Documentation Index
Fetch the complete documentation index at: https://docs.cavos.xyz/llms.txt
Use this file to discover all available pages before exploring further.
Requirements
- React Native 0.72+
- Expo SDK 54+ (recommended)
- iOS 16+ / Android 9+
- A Cavos App ID from the Dashboard
Installation
- npm
- yarn
Peer Dependencies
The SDK requires these Expo packages:| Package | Purpose |
|---|---|
expo-crypto | Cryptographic operations |
expo-secure-store | Secure key storage (Keychain/Keystore) |
react-native-passkey | Native passkey support |
Configuration
Required: rpId
The React Native SDK requires anrpId (Relying Party ID). This is the domain that validates your passkeys.
Configuration Options
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
appId | string | Yes | - | Your Cavos App ID |
rpId | string | Yes | - | Domain for passkey validation |
network | ’sepolia’ | ‘mainnet’ | No | ’sepolia’ | Target Starknet network |
paymasterApiKey | string | No | Cavos shared key | Custom AVNU Paymaster API key |
starknetRpcUrl | string | No | Alchemy RPC | Custom Starknet RPC URL |
Expo Configuration
app.json / app.config.js
Configure associated domains for passkey support:Development Build
Passkeys require a development build (not Expo Go):Passkeys do not work in Expo Go. You must use a development build or production build.
Exports
The package exports:| Export | Description |
|---|---|
CavosNativeProvider | React context provider |
useCavosNative | Main hook for SDK access |
CavosNativeSDK | Direct SDK class (advanced) |

