Key Features
OAuth Wallets
Your OAuth account IS your wallet. Same login = same wallet across all devices. No seed phrases.
JWT Verification
On-chain RSA signature verification of JWT tokens. Ephemeral keys registered via cryptographic proof.
Gasless Transactions
Users can transact without holding ETH. All gas fees are sponsored via AVNU Paymaster.
Cross-Platform
SDKs for both web (React) and mobile (React Native) with unified APIs.
How OAuth Wallets Work
Cavos creates self-custodial wallets tied to your OAuth identity:- User authenticates with Google, Apple, or Firebase email/password
- Provider issues JWT token with user identity (sub claim)
- Wallet address derived deterministically from OAuth user ID
- Ephemeral key generated for transaction signing (~24 hour lifetime)
- First transaction deploys account + registers session key via JWT verification
- All transactions signed automatically with session key - no prompts needed
[!NOTE] Your wallet address is computed from your OAuth identity. There are no private keys to manage - your Google/Apple/Firebase account IS your wallet.
Choose Your Platform
Web SDK
For React web applications. Uses WebAuthn for passkey authentication.
React Native SDK
For iOS and Android apps. Uses native passkeys with platform authenticators.
Authentication Methods
Cavos supports multiple ways to authenticate:- Google OAuth: Login with Google account
- Apple OAuth: Login with Apple ID
- Email/Password: Traditional auth with Firebase (email verification required)
- Passkey-Only: Anonymous wallets for privacy-focused apps
Quick Example
How It Works Under the Hood
First Transaction:- SDK signs transaction with session key
- Includes full JWT + RSA signature in calldata
- Account contract deploys itself via paymaster
- Contract verifies JWT RSA signature on-chain
- Ephemeral key is registered
- Transaction executes
- SDK signs with session key (lightweight signature)
- No JWT needed - key already registered
- Much cheaper gas cost
- Ephemeral keys auto-renew when they expire
Key Benefits
| Feature | Benefit |
|---|---|
| No Seed Phrases | Your OAuth account IS your wallet |
| Cross-Device | Same login = same wallet everywhere |
| Self-Custodial | You control your wallet, not Cavos |
| Gasless | Never need to buy crypto to transact |
| On-Chain Security | JWT verified on-chain, not by backend |
| Auto-Renewal | Ephemeral keys renew automatically |

