Getting started with Vega Wallet

To set up the self-hosted Vega Wallet, follow the instructions below. Using the self-hosted Vega Wallet ensures your keys will be completely disassociated from your personal identity, and Vega will have no way to connect them with you, unless you share your public key for any reason.

This software a work-in-progress and is frequently updated, and does not yet have a user interface.

How to install and run Vega Wallet

These instructions are written to be used in command line. Below, in the snippets, you’ll see commands in highlighted text. Copy those instructions and paste them into your command line interface.

Download

Download and save the zip file from Releases, in the go-wallet GitHub repo. We suggest you keep track of where you’ve saved the file, because that’s where the command line interface will look for it.

For MacOS:

Download vegawallet-darwin-amd64.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.

For Windows:

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 “vegawallet-windows-amd64” cannot be opened because it is from an unidentified developer.

Click on the (More info) text, which will reveal a button to “Run anyway”.

For Linux:

Download vegawallet-linux-amd64.zip

Generate key pair and credentials

Execute the program

Tip: 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.

Tip: You can use the tab key to auto-fill the name of the file, after you type the first few characters.

MacOS & Linux

Open a new terminal. Type

./vegawallet

to execute the program.

Windows

Open a new command prompt. Type

vegawallet

to execute the program.

Tip: You can see a list of available commands by running ./vegawallet -h on MacOS and Linux, or vegawallet -h on Windows.

Initialise the program

The init command (below) will initialise the configuration. A configuration file will be stored in your home folder, in a folder called .vega.

MacOS & Linux

./vegawallet init

Windows

vegawallet init

Tip: If you want to specify a root-path, it will not go into the default path, but a folder you choose to create. If you want to create a new config for a new wallet, or test or isolate it, you should specify the root path.

Create name and passphrase

Next, create a user name and passphrase for your Wallet, and create a public and private key (key generate).

Replace “YOUR_CUSTOM_USERNAME” (below) with your chosen username:

MacOS & Linux

./vegawallet key generate --name "YOUR_CUSTOM_USERNAME"

Windows

vegawallet key generate --name "YOUR_CUSTOM_USERNAME"

It will then prompt you to input a passphrase, and then confirm that passphrase. You’ll use this username and passphrase to login to Vega Console. (Instructions on connecting to Console are below.)

The key generate command in that instruction will generate public and private keys for the wallet, at the same time as creating a user name.

You’ll see a public and private key. DO NOT SHARE YOUR PRIVATE KEY. Keep your private key safe and secret.

Don’t forget to back up these keys.

Give each new key a nickname/alias

When creating a key, you can give an alias by adding a metadata named name.

MacOS & Linux

./vegawallet genkey --name "YOUR_CUSTOM_USERNAME" --metas "name:CHOOSE_CUSTOM_ALIAS_FOR_KEY"`

Windows

vegawallet genkey --name "YOUR_CUSTOM_USERNAME" --metas "name:CHOOSE_CUSTOM_ALIAS_FOR_KEY"

Give an existing key a nickname/alias

MacOS & Linux

./vegawallet meta --metas="name:CHOOSE_CUSTOM_ALIAS_FOR_KEY" --name="YOUR_CUSTOM_USERNAME" --pubkey="REPLACE_THIS_WITH_YOUR_PUBLIC_KEY"

Windows

vegawallet meta --metas="name:CHOOSE_CUSTOM_ALIAS_FOR_KEY" --name="YOUR_CUSTOM_USERNAME" --pubkey="REPLACE_THIS_WITH_YOUR_PUBLIC_KEY"

Tip: You can also use the meta command to tag a key with other data you might want, using a property name and a value. This will be useful for developing with Vega Wallet in the future.

Run the Wallet service

Now, connect your wallet to the Vega testnet (Fairground) nodes. To trade, run the wallet and start the Vega Console with the command below. (You’ll need collateral to trade, and you can deposit it through Vega Console, once you’re connected.)

MacOS & Linux

./vegawallet service run --console-proxy

Windows

vegawallet service run --console-proxy

Tip: If you’re running an ad/tracker blocker, and you’re getting errors, it may be blocking the node from connecting. Try allowlisting lb.testnet.vega.xyz and refreshing.

Tip: To terminate the process, such as if you want to run other commands in Wallet, use ctrl+c.

Create and deposit testnet tokens

Now you’ll need to deposit Ropsten Ethereum-based tokens to start trading.

You can create and deposit assets directly through the proxy Console via Wallet.

Click for a walkthrough of deposits on Vega Console.

If you’d prefer to request tokens from the contracts directly, there are instructions in the testnet bridge tools repo readme.

Visit the commands page for a full list of commands for Vega Wallet.