Logging in
When you first visit OneBalance, you’ll see the main application interface with a Login button in the top-right corner.1
Click the Login button
Locate the Login button in the header. It displays a wallet icon and the text “Login”.
2
Choose your login method
Privy will present several authentication options:
- Social accounts: Google, Twitter, Discord, Apple, etc.
- Email: Log in with a magic link sent to your email
- Existing wallets: Connect MetaMask, Coinbase Wallet, WalletConnect, or other supported wallets
- Phone number: Authenticate via SMS
3
Complete authentication
Follow the prompts for your chosen method:
- For social accounts, authorize OneBalance to access your profile
- For email, click the magic link sent to your inbox
- For existing wallets, approve the connection request in your wallet
- For phone, enter the verification code sent via SMS
4
Embedded wallet creation
After successful authentication, Privy automatically creates an embedded wallet for you. This happens behind the scenes - no additional setup required.Your embedded wallet is secured by Privy and linked to your authentication method.
If you’re logging in for the first time, Privy creates a new embedded wallet automatically. Returning users will connect to their existing embedded wallet.
Understanding your account address
Once authenticated, the Login button changes to display your connected wallet:- A green pulsing dot indicates you’re connected
- Your account address appears in shortened format (e.g.,
0x1234...5678) - A chevron icon indicates you can click to view wallet details
Account address vs. session address
OneBalance uses a predicted account address system:- Session address: Your Privy embedded wallet address (used for signing transactions)
- Account address: Your OneBalance smart contract account address (where your funds live)
Viewing wallet details
Click on the connected wallet button to open the wallet details dialog:1
Open wallet dialog
Click the wallet button in the header (shows your address and green dot).
2
View account information
The dialog displays:
- Wallet Header: Shows “Your Account” title
- Account Address: Your full OneBalance account address with a copy button
- Portfolio Summary: Total portfolio value across all chains
- Asset Balances: List of all tokens you hold with their values
3
Copy your address
Click the Copy button next to your account address to copy it to your clipboard.You’ll see a confirmation message when the address is copied.
4
Refresh balances
Click the refresh icon in the Portfolio Summary section to update your balances.Balances automatically refresh when you open the dialog, but you can manually refresh if needed.
Logging out
To disconnect your wallet and log out:1
Open wallet dialog
Click your wallet button in the header.
2
Click Logout
Scroll to the bottom of the wallet dialog and click the red Logout button.
3
Confirm logout
Your session will end immediately, and you’ll return to the logged-out state.
Security considerations
Your embedded wallet is secured by Privy’s infrastructure:- Private keys are encrypted and managed by Privy
- Authentication is required for all actions
- Transaction signing happens securely within the embedded wallet
- No seed phrases to manage or lose
Make sure to use a strong authentication method (like Google or email) and enable two-factor authentication on those accounts for maximum security.
Troubleshooting
Can’t log in
- Ensure you’re using a supported browser (Chrome, Firefox, Safari, Edge)
- Check that third-party cookies are enabled
- Try a different authentication method
- Clear your browser cache and try again
Don’t see my balances
- Click the refresh icon in the wallet dialog
- Ensure you’ve sent funds to the correct account address
- Wait a few moments for blockchain confirmations
Lost access to authentication method
If you lose access to your original authentication method:- Log in with an alternative method if you linked multiple
- Contact Privy support for account recovery options
- Your funds remain safe in your account address