Get started with Vega Wallet
You can now connect to an existing Vega wallet, or create a new wallet, using the Vega Wallet desktop app.
Set-up takes less than 5 minutes, from downloading the software to connecting to a Vega dApp.
The Vega Wallet desktop app has release and pre-release versions available. The newest release version is generally the version compatible with the latest mainnet release, while the pre-release version is compatible with the Vega testnet.
Download and start the Vega Wallet desktop app
Download, save and open app
1. Download and save the file
Get the latest version of the Vega Wallet desktop app from the GitHub releases page.
Keep track of where you've saved the file, because you will need to know where to look for it to use it.
Click through the tabs below to find out which download file you need.
- Windows
- MacOS
- Linux
You'll need Windows 8 or newer to use the desktop app.
For Windows devices with an AMD processor (aka x86-64):
Download vegawallet-desktop-windows-amd64.zip
For Windows devices with an ARM processor (See Windows FAQ):
Download vegawallet-desktop-windows-arm64.zip
You may need to change your system preferences for this specific instance, in order to run Vega Wallet. If you open the file from downloads, you may get a message from Windows Defender saying it prevented an unrecognised app from starting. Click 'More info' and then 'Run anyway'.
If you do not have WebView2 installed on your computer, you will be prompted to install it. Click "OK" to install and continue.
You'll need MacOS 10.13 (High Sierra) or newer to use the desktop app.
For Macs with an AMD processor (aka x86-64):
Download vegawallet-desktop-darwin-amd64.zip
For Macs with an M1 processor (See Apple guidance):
Download vegawallet-desktop-darwin-arm64.zip
Linux is generally supported, though the minimum version is unknown.
Download vegawallet-desktop-linux-amd64.zip
Antivirus software
If you are running antivirus software, you may need to ‘allowlist’ or ‘whitelist’ the Vega Wallet software, so that your antivirus provider doesn’t quarantine the software and block you from using it.
2. Extract the file
Click on the compressed folder to get access to the app.
3. Start the app
Double-click on the Vega Wallet desktop app icon to start the desktop app.
Use existing wallet
If you previously created a Vega wallet, such as using the CLI app, the first time you use the Vega Wallet desktop app you can choose to use an existing wallet.
If you are updating to a new version of the Vega Wallet desktop app, the app will load your existing Vega wallet (or wallets) on the wallet screen.
Generate new wallet
If you don't already have a Vega wallet, create a new wallet.
- Open the app
- Click on "Create new wallet"
- Enter a wallet name of your choice, and a passphrase.
- Your first keypair will be created for you. You can create more keys for that wallet but you only need one to start interacting with Vega.
- Choose a Vega network to connect to: Click on the arrow in the bottom bar of the app. If you do not have any network configuration, you can use the .toml URLs in the manage networks guide to import a network.
Restore wallet
If your Vega wallet was created on a different device, or you lost access to it but have the recovery phrase, you can recover the wallet using that recovery phrase.
- Open the app.
- Click on "Use recovery phrase"
- Enter your recovery phrase, exactly in the order that it was first presented to you.
- Identify if your wallet was version 1 or 2 by choosing the version number.
- Choose a Vega network to connect to: Click on the arrow in the bottom bar of the app. If you do not have any network configuration, you can use the .toml URLs in the manage networks guide to import a network.
Networks and nodes
Add or update network URLs
You can use the following network URLs to connect to mainnet or fairground networks through your wallet:
- Mainnet network (run by validators): mainnet1.toml
- Fairground network: fairground.toml
Connecting to stable nodes
You can change the list of data nodes in your network configuation to control how many nodes the wallet tries to connect to. The wallet connects to a data node in order to communicate with the network, and uses it to forward transactions to the consensus validator nodes.
The number of nodes that you have in the config list depends on how reliable you believe the nodes are, and how sensitive you are to the speed of your transactions being sent.
A shorter list of stable nodes will lead to the fastest transaction experience. If you think the nodes are unreliable, a longer list of nodes will provide diversity and more likelihood that the wallet will cycle through to find a connected node.
A balanced set up for one’s network configuration would be around 10 stable and trusted nodes, If any of them isn't able to connect, there are plenty of others for the wallet to connect through.
Configure the node list
To configure the node list your wallet uses, you'll need to be able to edit the .TOML file you're using. Unless you have self-hosted or cloned a network's config list, you will need to save it locally and update the network by uploading a file.
See the files linked in Network URLs for the structure of the network config file.
Updating the app
It's recommended that you keep the Vega Wallet app up-to-date, to take advantage of the latest features.
To update to the latest version:
- (Optional) Delete the old version of the Vega Wallet app, so you can keep track of which is the latest version. Currently, downloading a new version does not overwrite the previous one. Deleting the app will not delete your wallets or keys.
- Download the latest version for your operating system from GitHub.
- Click on the compressed folder to get access to the new app file.
- Open the latest version of the Vega Wallet desktop app.
Troubleshooting
The Vega Wallet desktop app does not yet have the full functionality of the CLI wallet app.
Not yet supported
To do any of the following, you will need to use the CLI wallet app:
- Customise key details
- Isolate keys
- Build and send commands
'Wallet already exists' error when recovering wallet
Problem
You recover a wallet using your recovery phrase. When you enter the wallet name, you get an error of Wallet with this name already exists
.
Solution
The wallet you are trying to recover already exists on your device. You can use your existing wallet with the Vega Wallet desktop app. On the onboarding screen, choose Use existing
to connect to an existing Vega wallet.
If you see the error message Wallet with this name already exists
but you do not see that wallet on the Wallets screen, then report the issue on the feedback board.
Wallet recovery provides wrong keys
Problem
You recover a wallet using your recovery phrase, and the public key you see doesn't match the key you expect (such as if you expected that key to have assets associated with it, and it doesn't).
Possible solutions
- Choose the alternate wallet version number alongside your recovery phrase. If you recovered and chose "version 2", then you should try using the same recovery phrase but choose "version 1".
- Ensure that your recovery phrase includes the exact same words, in the exact same order, as they were provided to you when you first created your wallet.
No networks available
If you chose not to import the available networks when setting up the wallet app, you will need to import them manually. Use the .toml URLs in the manage networks guide to import a network.
Reporting bugs
Report on the feedback board: If you discover a bug or are having problems with the Desktop Wallet app, report them on Vega's feedback board.