How do I
The following sections are dedicated to showing you how to perform specific tasks.
Click in the side navigation panel for specific tasks.
- Encrypt Vault Wallet
- Get a New Wallet
- Back up wallets
- Buy CHI
- Get an Account Name
- Transfer a Name
- Mine CHI
- Get Support
- Fix Stuck Wallet
— Top — Encrypt Vault Wallet — Get a New Wallet — Back up wallets — Buy CHI — Get an Account Name — Transfer a Name — Mine CHI — Get Support — Fix Stuck Wallet —
It is STRONGLY recommended that you encrypt your vault wallet.
You must back up your vault wallet after you encrypt it and ensure that you have stored your password for it safely. Failure to do so could result in lost CHI and lost blockchain assets.
Once you've encrypted your vault wallet, you'll no longer be nagged continually and forever by the XAYA Electron wallet to encrypt your vault wallet... and it will nag you forever... until you encrypt your vault wallet... with a password that you 100% promise to never lose or forget. Right?
Ideally, you should start with a 0 balance in your vault wallet and have no blockchain assets or names stored in it. The purpose here is to test your newly encrypted wallet with zero risk.
The following shows how to encrypt your wallet in a conservative (paranoid) manner that seeks to eliminate potential errors.
-
If you have any coins in your vault wallet, send them all to your game wallet. Check the "Subtract fee from amount?" checkbox. See here for how to send coins. Similar for other blockchain assets, i.e. names. Transfer any names to your game wallet. See here for how to transfer names.
-
Your empty vault wallet should look like this:
-
Decide on a password that you would like to use, and write it down or store it in a safe location, ideally in a password manager.
-
Click ENCRYPT WALLET.
-
Enter your password into the password field and click the ENCRYPT WALLET button. Ideally, you should copy your password from your password manager. It is possible that if you type your password, you could mistype it and that you could mistype it when you confirm your password. Copying your password from your password manager is the safest way to ensure that you enter your password correctly.
-
Confirm your password by entering it in again and clicking the Encrypt button. Pay attention to what happens next.
-
If your passwords don't match, you'll see this error message. Start again at step 5.
-
If your passwords match, you'll see this message but only briefly. The wallet software will automatically close.
-
Restart the wallet software.
-
Ensure that the vault wallet is selected. See here for how to select the vault wallet.
-
Test your new password by clicking UNLOCK WALLET in the upper-right corner of the wallet on the Overview screen and entering your password.
-
If your wallet was successfully unlocked, you will see a message in the upper-right corner of the wallet on the Overview screen.
-
If you did not enter your password correctly, you will see a message similar to the figure below.
-
If you entered the wrong password, start again at step 11. If the error persists, then you've failed to properly encrypt your wallet with a password that you can reliably enter. (This is why your wallet should be empty as per the notice above in step 1.) See Get a New Wallet for information on how to get a new vault wallet to encrypt. After that, start over at step 1.
— Top — Encrypt Vault Wallet — Get a New Wallet — Back up wallets — Buy CHI — Get an Account Name — Transfer a Name — Mine CHI — Get Support — Fix Stuck Wallet —
If for any reason you want or need a new wallet, it's very simple to do.
This is simple for advanced users. If you aren't comfortable working outside of regular user folders, proceed with caution and always make backups of your wallets as described in Settings.
The XAYA Electron wallet has 2 wallets: a game wallet and a vault wallet. They are located here:
C:\Users\<user>\AppData\Roaming\Xaya\wallets
On Linux with the QT wallet software, the wallet is located here:
~/.xaya/wallets
Or here:
~/home/<user>/xaya/wallets
On OS X (Mac) with the QT wallet software, they are here:
~/Library/Application Support/Xaya/wallets/
On Windows, in that folder are 2 folders:
- game.dat
- vault.dat
Inside of each of those folders is a wallet.dat file.
To replace a wallet.dat file:
-
Shut down your wallet software if it's not already shut down.
-
Navigate to the folder of the wallet that you wish to replace.
-
Rename the wallet.dat file with a description that's meaningful to you. For example:
Old wallet - empty.dat
By renaming your wallet, you can go back and rename it back to wallet.dat so that you can use it again.
At this stage, you will not have a file named "wallet.dat" in that folder.
-
Restart your XAYA Electron wallet. It will automatically create a new, empty wallet.dat for you.
Take note that the process above does not delete the old wallet.dat file. If you are certain that the wallet has nothing of value, you may wish to delete it. If you are replacing a wallet because you have lost the password, you should still keep the wallet as it may be possible to retrieve the wallet's password.
— Top — Encrypt Vault Wallet — Get a New Wallet — Back up wallets — Buy CHI — Get an Account Name — Transfer a Name — Mine CHI — Get Support — Fix Stuck Wallet —
It is critically important that you back up your wallets. Failure to do so could result in the loss of your CHI and blockchain assets.
There are 2 ways to back up your wallets.
- Use the back up feature in the XAYA Electron wallet to back them up to a safe location
- Manually back up your wallets by copying them to a safe location
Your back ups should be stored in a "safe location". This will have different meanings for different people. One person may want a physical printout and multiple USB sticks stored in a bank vault, while another considers a file backup on the same drive a safe location. This has entirely to do with your risk tolerance and what you consider safe. The following backup methods are to help you decide on what is right for you.
The easiest way to back up your wallets is to use the backup feature in Settings.
Click here for help with the built-in backup feature.
Unless you are comfortable with manual backups, you should only use the built-in backup feature.
The following explains in detail how to back up your wallets manually.
NOTE: This is for advanced users. If you have any difficulty whatsoever with anything below, you should use the backup features in the Electron or QT wallet software.
XAYA has 3 distinct wallets depending on which wallet software you are running. One wallet is used by the XAYA QT wallet, while the XAYA Electron wallet has 2 wallets, the game and vault wallets. You only need to copy each wallet.dat file to a safe location to back them up.
Click here to skip to the wallet locations.
The XAYA QT wallet can be found in the datadir wallets folder on Windows here:
%APPDATA%\Xaya\wallets\
e.g. C:\Users\<user>\AppData\Roaming\Xaya\wallets\
On Linux the wallet folder is here:
~/.xaya/wallets/
Or here:
~/home/<user>/xaya/wallets/
On OS X (Mac) the wallet folder is here:
~/Library/Application Support/Xaya/wallets/
The XAYA Electron wallets are in the game.dat and vault.dat subfolders. On Windows, those are here:
%APPDATA%\Xaya\wallets\game.dat\
%APPDATA%\Xaya\wallets\vault.dat\
e.g.
C:\Users\<user>\AppData\Roaming\Xaya\wallets\game.dat\
C:\Users\<user>\AppData\Roaming\Xaya\wallets\vault.dat\
The XAYA Electron wallet is not yet available for Linux or OS X (Mac).
Backing up wallet files is only a matter of copying them to a safe location. The Electron wallet has 2 wallet files while the QT wallet has only 1 wallet file.
The 3 possible wallet locations to back up are:
%APPDATA%\Xaya\wallets\wallet.dat
%APPDATA%\Xaya\wallets\game.dat\wallet.dat
%APPDATA%\Xaya\wallets\vault.dat\wallet.dat
Or on Linux for the QT wallet:
~/.xaya/wallets/wallet.dat
And on OS X for the QT wallet:
~/Library/Application Support/Xaya/wallets/wallet.dat
If you haven't run the XAYA QT wallet, you will not have that file. This is normal.
To back up a wallet file:
-
Shut down the wallet software.
-
Copy the wallet.dat file to 1 or more safe backup locations.
-
Restart your wallet software.
— Top — Encrypt Vault Wallet — Get a New Wallet — Back up wallets — Buy CHI — Get an Account Name — Transfer a Name — Mine CHI — Get Support — Fix Stuck Wallet —
CHI can be purchased from anyone willing to sell it. The XAYA team has no control over who buys or sells CHI.
CHI may be purchased on an exchange.
Check the XAYA forums at https://forum.xaya.io/ or Telegram channel at https://t.me/xaya_en/ for any exchange listings.
— Top — Encrypt Vault Wallet — Get a New Wallet — Back up wallets — Buy CHI — Get an Account Name — Transfer a Name — Mine CHI — Get Support — Fix Stuck Wallet —
Names are used as accounts inside of games. See Create Names for information on how to create your own names.
— Top — Encrypt Vault Wallet — Get a New Wallet — Back up wallets — Buy CHI — Get an Account Name — Transfer a Name — Mine CHI — Get Support — Fix Stuck Wallet —
You can transfer names between your game and vault wallet, or you can transfer a name to another person using one of their CHI addresses.
To transfer a name:
-
Click My Names in the left-side navigation.
-
Find the name that you wish to transfer.
-
On the right-hand side on the same line as the name you wish to transfer, click TRANSFER.
-
Paste the address that you want to transfer the name to in the input.
-
Click OK to transfer the name.
-
A dialog with the transaction ID appears. Click OK to close it.
Your name will remain in your wallet while the transfer is being confirmed. Once it is confirmed, it will disappear.
Once you have transferred the name to your other wallet, you can check My Names or Transactions in that wallet.
— Top — Encrypt Vault Wallet — Get a New Wallet — Back up wallets — Buy CHI — Get an Account Name — Transfer a Name — Mine CHI — Get Support — Fix Stuck Wallet —
Mining is a complex topic and beyond the scope of this help file.
See the Mining forum for information and help.
— Top — Encrypt Vault Wallet — Get a New Wallet — Back up wallets — Buy CHI — Get an Account Name — Transfer a Name — Mine CHI — Get Support — Fix Stuck Wallet —
Visit the XAYA Support forum for general support.
— Top — Encrypt Vault Wallet — Get a New Wallet — Back up wallets — Buy CHI — Get an Account Name — Transfer a Name — Mine CHI — Get Support — Fix Stuck Wallet —
There are different reasons why your wallet may get stuck synchronising.
Advanced users may wish to run the wallet from the command line with a "-reindex" and/or "-rescan" option.
You can also delete the blockchain data and resynchronise. See Delete Chain for more information.
— Top — Encrypt Vault Wallet — Get a New Wallet — Back up wallets — Buy CHI — Get an Account Name — Transfer a Name — Mine CHI — Get Support — Fix Stuck Wallet —