Troubleshooting / FAQ
Last updated
Last updated
Are you using a desktop device and Chrome browser?
Fluvi Wallet currently offers all its features properly only in this environment. Features may not work properly in environments like Brave, Edge, Firefox, etc.
Did you install Fluvi Wallet through the official Chrome Web Store, not a zip file or something like that?
You must install directly from the Chrome Web App Store for the login to work. We use this method to prevent app modification or abusing.
Are you using the latest version?
Check if the version information on the Chrome Web Store matches the version information of the wallet you are using. Refer to the update instructions in the recovery section of this document for how to update.
Are Fluvi Wallet and Metamask set to the Linea Testnet chain?
Fluvi Wallet is set to Linea Testnet by default. Make sure the Metamask you are trying to connect is also connected to Linea Testnet.
Have you connected Fluvi Wallet with WalletConnect?
Connect Fluvi Wallet in the method mentioned in step 2. Be sure to turn off the "Set as Default Wallet" in the settings.
Are each of the wallet addresses correctly connected?
Please confirm that the connection is correct for both the Fluvi Wallet and the Metamask addresses you found in step 6.
Disconnect all connections, unlock your session in settings, restart your browser, and proceed with the rest of the process.
If the problem continues, you may try the following:
Try creating a new wallet within your current account. Sign out from the wallet after selecting the new wallet and going back to the original wallet, then sign in again. Proceed with the rest of the process.
Decoding Error message on mapping page:
Invalid fluviAddress
You may have connected Metamask at fluvi section instead of doing the wallet connect with fluvi.
Ownership check failed
Haven't made any transaction yet with Fluvi wallet.
Fluvi wallet already mapped
Already mapped.
You cannot receive the Faucet again if you've already received it or tried to receive it again or if you've reset the wallet. If you want to use the wallet in question, receive ETH from another Faucet or externally.
: A Fluvi Wallet account can only be connected with one Metamask address. Create a new Fluvi Wallet account if you want to connect with another Metamask address.
This happens when you've reinstalled the wallet or want to use it on another device. If you didn't back up beforehand, the only option is to reset the wallet. In this case, you won't be able to use the existing wallet again. Please refer to the following for how to reset.
It could be a backup made before resetting your accounts. If you're sure the backed-up account is correct but recovery doesn't proceed, please contact our Discord community.
The mapping information always keeps the last Fluvi Wallet address connected to Galxe.
Did you connect to the dApp in the correct way?
PancakeSwap, Velocore: WalletConnect
Compound, SushiSwap: Turn on the "Set as Default Wallet" option, then refresh and connect with Metamask for use.
If you reinstall the wallet or try to use it on a different device, you need to authorize the newly installed Fluvi Wallet. If you cannot authorize from the previously connected device, or perform "Emergency Recovery", then "Account Reset" is required.
If you proceed "Account Reset", you will lose all assets in your existing account. Please make sure you cannot recover them before doing so.
Check if you are using the latest version of Fluvi Wallet. You can check the current version of Fluvi Wallet in the upper right corner of the unlock screen or in the About tab in Settings.
If your version is lower than the version published in the Crome Web Store, turn on developer mode in the Extensions setting in Chrome and update your app.
Click on the Account tab in Settings and execute Reset Account.
After the reset, launch Fluvi Wallet again to onboard as you did the first time. If there is a device registration popup, "Cencel" it. This is from the device before the reset and should not be done.
What to be aware of when retrying mapping
After resetting, revisit https://linea-quest.fluvi.io/.
Go to step 2 and check that you have a connected wallet. If a wallet is already connected from step 2, disconnect it and reconnect to ensure that your new wallet address is displayed.
If you have already received the faucet before, you cannot receive it again. Currently, you must obtain ETH through other means and leave a transaction in order to complete Mapping.
As described in the guide above, WalletConnect does not technically support transaction pop-ups. Please refer to the guide and check the badge on the Fluvi Wallet Icon and Notification tab.
For a user experience with pop-ups, you need to set Fluvi Wallet as a default wallet and use it as if you are connecting MetaMask. Please refer to the above section "Can't connect to dApp / WalletConnect is not working".
Most instances where gas estimation appears as 0, or transactions can't be processed due to an 'unknown error', stem from instability issues with the bundler and the network. We're currently experiencing high gas fees and unstable network conditions due to the sheer number of users trying Linea Voyage. Please be assured that we're monitoring the situation closely, working with our partners and working tirelessly to resolve these issues as quickly as possible. If you encounter such problems, we recommend waiting a bit before trying to complete the quest again. We apologize for any inconvenience caused and appreciate your patience and understanding.
Most of the problems you encounter when interacting with dApps through Fluvi Wallet are likely related to WalletConnect. Fluvi Wallet supports dApp use via Wallet Injection, so try to solve the problem through this.
Go to Settings (Left sidebar or search in the top bar)
Turn on the "Set as Default Wallet" option in the Extension part
Refresh and proceed with MetaMask connection
If connected to the Fluvi Wallet's address, use the dApp
(Option) Disable the "Set as default wallet" option after use
If the option is not disabled, all MetaMask connections will be connected to Fluvi Wallet.
Fluvi Wallet offers convenient multi-device synchronization through keychain technology. Please check the link below for more information.
Once the mapping is complete, Galxe periodically updates, which can take some time, so you should wait and revisit later. On the Voyage page, you can check the last update time by hovering over the verify button.
PancakeSwap
Velocore
Compound
SushiSwap
This means that only quests from dApps that are sponsored by Fluvi Wallet are confirmed to be achievable. Please proceed with quests of other dApps first through MetaMask and complete them in Galxe. Do not expect that if you have completed tasks with Fluvi Wallet for dApps other than those mentioned above, they will necessarily be reflected.
Please use the Bug Report page from the sidebar or contact us through our Discord community.
