Create a wallet
To download Vega Wallet and create your wallet, follow the step-by-step instructions below. These instructions cover version 0.12, the latest release, and also work for version 0.11. You can refer to documentation for 0.10.0 or earlier if you need it.
This software a work-in-progress and is frequently updated, and does not yet have a user interface.
Note: If you are looking for instructions for connecting your hardware wallet to MetaMask, see MetaMask's guide.
Use the following instructions in command line. Below, you'll see commands in the code blocks for each operating system. Copy those instructions and paste them into your command line interface.
caution
You must to use Vega Wallet version 0.9.2 or newer to connect to Vega Mainnet. We recommend always using the latest released version of Vega Wallet.
info
In your command line interface, you can view a list of available commands by running ./vegawallet -h
on MacOS and Linux, or vegawallet -h
on Windows. Help is also available for every command, for example: vegawallet create -h
will provide information about the create
command.
1. Install and run latest Vega Wallet version (0.12)
Download file
Download and save the zip file from Vega Wallet software releases. Keep track of where you've saved the file, because that's where the command line interface will look for it.
You may need to change your system preferences to run the file.
- Windows
- MacOS
- Linux
Download vegawallet-windows-amd64.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 on the (More info) text, which will reveal the option to "Run anyway".
Download vegawallet-darwin-amd64.zip
For Macs with an M1 processor (released since November 2020):
Download vegawallet-darwin-arm64.zip
When you open the file, 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 saying "vegawallet-darwin-amd64
cannot be opened because it is from an unidentified developer".
Click on the (?)
help button, which will open a window that links you to the System Preferences
, and instructs you how to allow this software to run.
You’ll need to go to System Preferences
> Security & Privacy
> General
, and choose Open Anyway
.
Apple also provides instructions for opening unsigned apps (Apple support)
Download vegawallet-linux-amd64.zip
info
You'll need to run the commands from the directory you've saved the wallet file in. Use the command pwd
to find out where your terminal is looking in the file system. Use the command cd
and the path/to/wallet/directory to tell the command line where to find the file.
2. Generate new wallet
The steps below will guide you through initialising a wallet, and creating new key pairs or importing an existing wallet.
info
To restore a wallet from your recovery phrase, see the restore a wallet guide.
Initialise the software
The init
command will initialise the software the first time you use it. This creates the folders and the configuration files needed by the software to operate.
- Windows
- MacOS
- Linux
vegawallet init
./vegawallet init
./vegawallet init
Create your wallet
Next, create a wallet by giving it a name and passphrase.
This step will:
- create your first public and private key
- show your wallet's recovery phrase (save this immediately)
Replace MY_WALLET_NAME
(below) with your chosen wallet name:
- Windows
- MacOS
- Linux
vegawallet create --wallet "MY_WALLET_NAME"
./vegawallet create --wallet "MY_WALLET_NAME"
./vegawallet create --wallet "MY_WALLET_NAME"
It will then prompt you to input a passphrase, and then confirm that passphrase. You'll use this wallet name and passphrase to login to the token site and Vega Console.
warning
Keep your recovery phrase safe and secret. You will need it to import your keys.
Your recovery phrase is only shown once ever and cannot be recovered. DO NOT SHARE YOUR RECOVERY PHRASE.
3. Choose a network
If you want to interact with the Token dApp or Vega Console, you'll need to import network configuration for the network(s) you want to connect to.
Import networks
Import the following network configurations:
- Mainnet network (run by validators):
mainnet1.toml
- Fairground network:
fairground.toml
info
To update your networks list, see manage networks for instructions.
Import networks from URL
Use the following command to import from URL.
The URL used below is for mainnet, update the URL if you want to import a different network.
- Windows
- MacOS
- Linux
vegawallet network import --from-url https://raw.githubusercontent.com/vegaprotocol/networks/master/mainnet1/mainnet1.toml
./vegawallet network import \
--from-url https://raw.githubusercontent.com/vegaprotocol/networks/master/mainnet1/mainnet1.toml
./vegawallet network import \
--from-url https://raw.githubusercontent.com/vegaprotocol/networks/master/mainnet1/mainnet1.toml
Import networks from file
Alternatively you can import a network list from a file. Use the following command to import from file:
- Windows
- MacOS
- Linux
vegawallet network import --from-file "PATH_TO_FILE"
./vegawallet network import --from-file "PATH_TO_FILE"
./vegawallet network import --from-file "PATH_TO_FILE"
info
Each network has a default name. You can rename the network using the --with-name
flag.
List imported networks
To see the names of the networks you imported, run the following command:
- Windows
- MacOS
- Linux
vegawallet network list
./vegawallet network list
./vegawallet network list
4. Run the wallet
For applications to be able to talk to your wallet, you will need to run the service. Every time you run the service, you will have to choose which network you need. Choose the network name from the list in step 3.
To choose a network and run the wallet, use the following command:
- Windows
- MacOS
- Linux
vegawallet service run --network "NETWORK_NAME"
./vegawallet service run --network "NETWORK_NAME"
./vegawallet service run --network "NETWORK_NAME"
info
To terminate the process, if you want to run other commands in Vega Wallet for example, use ctrl+c
.
4a. Connect to Vega apps through the wallet
In some cases, you'll need to run a Vega app via the wallet service, instead of directly in your browser.
Connect to Token dApp
- Windows
- MacOS
- Linux
vegawallet service run --network "NETWORK_NAME" --with-token-dapp
./vegawallet service run --network "NETWORK_NAME" --with-token-dapp
./vegawallet service run --network "NETWORK_NAME" --with-token-dapp
Connect to Vega Console
- Windows
- MacOS
- Linux
vegawallet service run --network "NETWORK_NAME" --with-console
./vegawallet service run --network "NETWORK_NAME" --with-console
./vegawallet service run --network "NETWORK_NAME" --with-console