FAQs
Quick answers to the most common questions.
Quick answers for users and integrators.
Integrating Revibase? Start with Quickstart.
For developers
Do I need a backend?
Yes.
You need a server endpoint that holds PRIVATE_KEY and processes the client authorization callback.
See the backend callback section in Quickstart.
Why do I need /.well-known/revibase.json?
Revibase fetches it from your domain to discover your app identity and verify your client public key (clientJwk).
See the well-known section in Quickstart.
Why does the browser block the popup?
Call signIn and transaction methods from a direct user gesture (click/tap).
Do I need to call signIn before transferTokens?
No.
transferTokens works without a signer.
It returns { txSig, user }, so you can learn the user wallet details from the payment result.
How do I know the payment is final?
Use your Solana RPC to fetch the transaction by txSig and confirm it landed on-chain.
Many RPC clients expose this as getSignatureStauses(txSig) or getTransaction(txSig).
When should I use channels?
Use channels for two-device flows.
Example: one screen shows the cart, the phone approves the payment.
How does it work?
What is a passkey?
A passkey is a WebAuthn credential stored in your device’s keychain.
You approve with Face ID, Touch ID, a PIN, or a security key. Revibase never receives your passkey private key.
What is a smart contract wallet?
A smart contract wallet is an on-chain wallet controlled by code.
It checks rules before a transaction is allowed. Rules include wallet members and approval thresholds.
How is this different from a traditional wallet?
Traditional wallets use a seed phrase and one private key.
Revibase uses passkeys and rule-based approvals. You approve in-app without a wallet extension.
What happens when I approve a transaction?
The app creates a request (sign-in or transaction).
You review the details in the Revibase popup.
You approve with a passkey.
The wallet verifies the approval and executes on Solana.
Security & Access
Where is my passkey stored?
Your passkey is stored in your device’s secure keychain.
Revibase cannot retrieve or export it.
Your passkey may sync via iCloud Keychain or Google Password Manager, if enabled.
What happens if I lose my device?
If your passkey syncs, sign in again on a new device. If it doesn’t sync, recovery depends on your wallet rules.
Best practice:
Add at least one additional wallet member.
Use a second-device passkey or a standard Solana wallet.
Can Revibase access my private keys?
No.
Your passkey private key stays on your device. Revibase only forwards your approval on-chain.
What happens if Revibase shuts down — can I still access my funds?
Your funds live on Solana in a smart contract wallet. Revibase does not custody them.
Passkeys are scoped to the relying party (domain). If the Revibase app is unavailable, you may lose the ability to sign with that passkey.
To plan for recovery, add a standard Solana wallet as an additional wallet member.
Can someone approve a transaction without my knowledge?
Not without a valid approval. Passkeys require user presence (Face ID / Touch ID / PIN). Always verify what the popup shows before approving.
Is Revibase open source?
Yes.
The smart contract code is public on GitHub.
Using Revibase
Which tokens and assets does my wallet support?
SOL and SPL tokens on Solana. That includes stablecoins like USDC.
Are there any fees charged by Revibase?
Revibase does not charge a fee to sign. You still pay standard Solana network fees.
Can I send funds directly from Revibase, or only through third-party apps?
Yes. Manage your wallet at app.revibase.com.
Revibase also works inside third-party apps that integrate it.
Which devices and browsers are supported?
Revibase works in browsers that support passkeys (WebAuthn). Chrome, Safari, and Edge are the typical baseline.
Do I need to install a wallet app or browser extension?
No.
Everything happens within the app you’re already using. When a signature is required, a Revibase popup appears. No extension is required.
Can I use a hardware security key instead of Face ID?
Yes. USB and NFC security keys that support passkeys work.
How do I create a Revibase wallet?
You can create one at app.revibase.com.
Can I use my wallet across multiple apps?
Yes. Any app that integrates Revibase can connect to your wallet.
Who controls my funds?
You do. Your funds are held on-chain in your smart contract wallet. Approvals require your passkey.
Last updated