Here is a step-by-step guide to creating and restoring your Keyless Wallet.
Create a Keyless Wallet
Download the App: Download the OneKey App from the official website.
Initiate Setup: Click "Continue with Google" on the welcome screen, or tap the "•••" button → Keyless Wallet → Select Google or Apple. Follow the prompts to verify and link your account.
Set Your PIN: Set a 4-digit PIN.
Important: You will need this PIN to log in on new devices and to recover your wallet if you lose your current device.
Create a Passcode: Create a local App Passcode. This unlocks your OneKey app on the current device and does not replace your PIN.
Success! You’ve successfully created a Keyless Wallet linked to your Google or Apple account and secured with your 4-digit PIN.
Warning: OneKey cannot reset your PIN if it is lost. Do not share it with anyone, including OneKey support.
Restore Your Keyless Wallet
Initiate Recovery: Click "Continue with Google" or the "•••" button → Keyless Wallet → Select Google or Apple. Follow the prompts to verify your account.
Verify PIN: Enter your 4-digit PIN.
Finalize: Create or verify your local App Passcode.
You have now successfully restored access to your wallet.
Troubleshooting: Restore Missing Accounts
When you restore access on a new device or after reinstalling the app, OneKey automatically retrieves only your first account (Account 1) by default. If you had additional accounts (e.g., Account 2, Account 3), they may not appear initially. Rest assured, they are not lost, and your funds are safe.
To add missing accounts manually:
Tap the Account Selector in the top-left corner of the wallet page.
Select "Add Account" at the bottom.
Repeat this step until all your previous accounts appear.
Alternative Method: Tap the "+" next to the search bar → Manage Accounts → Select the account you wish to recover.
(Optional) You can delete any extra empty accounts you do not need.
Frequently Asked Questions (FAQ)
Q: How is this secure?
When you create a Keyless Wallet, your wallet still possesses a recovery phrase fundamentally. However, OneKey encrypts it, and the encryption key is split into two parts:
One part is held by OneKey.
The other part is stored across the decentralized Juicebox network. No single party—not even OneKey—can decrypt your wallet without both your email authentication and your PIN.
Q: What is the PIN used for?
Your PIN is used to verify your identity when logging into a new device and to recover your wallet if your current device is lost or damaged.
Q: What if I forget my PIN?
If you forget your PIN, the solution depends on your login status:
If you are still logged in on another device (Desktop, Extension, or Mobile App): You can reset your PIN by going to Settings → Security → Reset PIN. You can then use the new PIN going forward.
If you are NOT logged in on any device: Unfortunately, your wallet cannot be recovered. For security reasons, OneKey does not store your PIN and cannot reset it for you.
Q: What happens if I enter the wrong PIN too many times?
After 7 incorrect attempts, the system will delete the encrypted backup for security. You will then only be able to recover your wallet if you still have a device that is already logged in.
Q: Can I reset or change my PIN?
Yes. On any device where you are currently logged in, open OneKey and navigate to Settings → Security → Reset PIN.
Q: Can I change the email I used to create my wallet?
No. You cannot change the Apple ID or Google account email associated with an existing wallet. However, you can create a new Keyless Wallet with a different email and transfer your assets to it.
Q: Can I link my email to an existing recovery-phrase wallet?
No. You cannot add an email login to a standard wallet originally created with a 12/24-word recovery phrase. They are separate wallet types.
Q: Does my Keyless Wallet still have a recovery phrase?
Yes. Even though you log in with Google or Apple, your wallet is mathematically derived from a recovery phrase. This phrase is encrypted and stored securely on your device, but you generally do not need to manage it manually.
