File System Wallet

This document describes how to create and use a file system wallet with the Velas CLI tools. A file system wallet exists as an unencrypted keypair file on your computer system's filesystem.

File system wallets are the least secure method of storing VLX tokens. Storing large amounts of tokens in a file system wallet is not recommended.

Before you Begin

Make sure you have installed the Velas Command Line Tools

Generate a File System Wallet Keypair

Use Velas command-line tool velas-keygen to generate keypair files. For example, run the following from a command-line shell:

mkdir ~/my-velas-wallet
velas-keygen new --outfile ~/my-velas-wallet/my-keypair.json

This file contains your unencrypted keypair. In fact, even if you specify a password, that password applies to the recovery seed phrase, not the file. Do not share this file with others. Anyone with access to this file will have access to all tokens sent to its public key. Instead, you should share only its public key. To display its public key, run:

velas-keygen pubkey ~/my-velas-wallet/my-keypair.json

It will output a string of characters, such as:


This is the public key corresponding to the keypair in ~/my-velas-wallet/my-keypair.json. The public key of the keypair file is your wallet address.

Verify your Address against your Keypair file

To verify you hold the private key for a given address, use velas-keygen verify:

velas-keygen verify <PUBKEY> ~/my-velas-wallet/my-keypair.json

where <PUBKEY> is replaced with your wallet address. The command will output "Success" if the given address matches the the one in your keypair file, and "Failed" otherwise.

Creating Multiple File System Wallet Addresses

You can create as many wallet addresses as you like. Simply re-run the steps in Generate a File System Wallet and make sure to use a new filename or path with the --outfile argument. Multiple wallet addresses can be useful if you want to transfer tokens between your own accounts for different purposes.