GUI Troubleshooting

This guide will help you debug common problems and should be reviewed before requesting support on Discord.

Startup

The GUI has a message “CLI Loading…” but never loads.

Generally, this means the CLI is having trouble starting. This usually happens if the CLI is already running. The first thing you should try is simply restarting your computer and then relaunching the GUI. This will eliminate the possibility of a rogue CLI process running.

I have restarted, but I’m still having this problem.

You may have a corrupt database file. Ensure your private keys(s) are backed up, the follow these steps:

Note: The database folder keeps the original network’s name, RBX, for backwards compatibility. This may be migrated in the future.

1. Close your wallet.

2. Ensure VerifiedXCore (the CLI) is not running. You can either:

   a. Restart your computer AGAIN

   b. Check your Task Manager (Windows) or Activity Monitor (MacOS) for a process called VerifiedXCore and end it. Please note that this is a background process and you may need to switch to the advanced mode. If you are not familiar with how to do this, use option a above instead.

3. Navigate to your DB Folder

   a. Windows: This will be located in C:\Users\{username}\AppData\Local. Note, you may need to enable Hidden Files to see the AppData folder in your user directory.

   b. MacOS: This will be located in /Users/{username}.

4. Delete the folder called RBX.

5. Launch your GUI.

Could be a permission issue (Windows)

On some versions of windows, you may run into permission problems with the core CLI launching the API. To solve this issue you’ll want to set both the GUI and the CLI to run as adminstrator:

1. Navigate to the wallet’s install folder, usually C:\Program Files (x86)\VFXWallet\

2. Right click on VFXWallet.exe and choose Properties

If you don’t see VFXWallet.exe it’s likely because you don’t have extensions visible on your machine. Instead, just look for VFXWallet.

3. Go to the compatability tab and click Change settings for all users

4. Enable the checkbox for Run this program as administrator and click OK, and then OK again.

5. Navigate into the VFXCore folder and repeat the same step for VerifiedXCore.exe

If you don’t have extensions visible, look for VerifiedXCore with the VFX cube icon.

6. Then launch the GUI as normal and everything should work as expected.

It’s still not working.

If it is not a rogue process or a corrupted database, the next step is to launch the CLI manually.

1. Ensure your wallet is closed and no CLI processes are running (follow instructions above).

2. Launch VerifiedXCore

   a. Windows: navigate to C:\Program Files (x86)\VFXWallet\VFXCore. Then, launch VerifiedXCore.exe. Note: you may not see .exe depending on your Windows’ settings.

   b. MacOS: navigate to /Applications and right click on VFXWallet.app and then choose Show Package Contents. Open up Contents > Resources > VFXCore and then launch VerifiedXCore.

3. You should see the CLI booting up and blocks coming in. If an error message occurs, check the following:

   a. You are on latest version

   b. Your disk space is not low (be sure you have at least 10GB of free space on your primary drive)

   c. Note: if the terminal window just launches and disappears, it likely means you already have the CLI running. Restart your computer.

4. If there are no errors, type in 10 and press enter which will enable the API.

5. Visit this URL in your web browser: http://localhost:7292/api/V1/CheckStatus.

6. You should see Online in your web browser.

   a. If you do not, please reach out to the Support Channel on Discord.

   b. If you do, you should be able to launch your GUI now.

7. If your GUI did launch successfully, the best thing to try now is closing your GUI (which will also end the CLI session) and then relaunching the GUI. If it doesn’t start up this time, please reach out to the Support Channel on Discord.

Incorrect Balance

Usually this is because you haven’t reached the local block height where the transaction occurred. Compare your local block height to the Network Explorer.

It’s also possible you haven’t imported the correct key(s). Double check those.

In the case that it’s still off, sometimes a state tree rebuild can help. You’ll need to force quit VerifiedXCore in your Task Manager (Windows) or Activity Monitor (MacOS) and then close the GUI. Restart the GUI and the state tree will rebuild.

I imported a snapshot and lost my keys

As mentioned during the snapshot import process, you must backup your keys before proceeding as this process wipes your entire RBX folder. Luckily, a backup was created.

1. Close your wallet.

2. Navigate to where your RBX folder and there will be a sibling folder to it called VFX_BACKUP_{timestamp}.

3. You can simply delete the current RBX folder and then rename the backup one to RBX.

4. Relaunch wallet and you will see your keys. Back them up then, if you’d like to proceed with the snapshot import, close your wallet, delete the RBX folder, and then relaunch.

TIP

Not seeing the answer you’re looking for? Just ask the community!

Join Discord