Navigation - RenegadeMinds/testbed GitHub Wiki
— Top — Overview — Receive — Send — Transactions — Create Names — My Names — Settings — Console — Exit —
The Overview is the "home" screen for the wallet.
It displays basic information about how many coins you have, network information, version information, and the block synchronization of the wallet.
— Top — Overview — Receive — Send — Transactions — Create Names — My Names — Settings — Console — Exit —
The Balance area on the Overview screen displays how much CHI you have in the currently selected wallet.
It displays the amount in full to 8 decimal places.
Should you "be surprised" at an amount in your wallet, it may be that you've simple got the wrong one selected.
See Wallets for more information.
The Network Info area displays basic information about the blockchain.
- Connections: Shows how many active connections you have to other XAYA nodes around the world.
- Net Type: Tells you whether you are on mainnet (this is where you play games) or on testnet (this is where testing is done).
- Is Pruned?: Tells you whether you're running with the full blockchain (false) or with a shorter version (true).
- Median Time: Just the time. It updates periodically, and not in real time.
The version area displays the current XAYA Electron wallet version and the current XAYA daemon version.
The Block Progression area shows you the latest block that you've downloaded from the network, and the current block height. If they are equal, your wallet is (probably) synchronised with the network.
If you cannot get your wallet to synchronise properly, visit the XAYA forums and post in the Support forum.
It is possible that during a lengthy synchronisation, the two numbers could be equal for a very short period without your wallet being fully synchronised due to there being more blocks to be downloaded still. This is rare and only lasts a very short time.
— Top — Overview — Receive — Send — Transactions — Create Names — My Names — Settings — Console — Exit —
The Receive screen lets you create CHI addresses where you can receive CHI.
To create an address:
-
In the Address Label input, enter a label, e.g. "My address".
-
Click INSERT.
-
Your new address appears in the Receiving Addresses list.
You can select the address and press CTRL+C or you can click COPY to copy the address to the clipboard.
— Top — Overview — Receive — Send — Transactions — Create Names — My Names — Settings — Console — Exit —
The Send screen lets you send CHI to other people at their CHI addresses.
To send CHI to another CHI address:
-
Paste the address into the Pay to Address input. (Do not type addresses.)
-
Enter how much CHI you want to send into the Amount Value input.
-
Optionally, you can choose to enter the amount in CHI, mCHI or uCHI. (Using the default CHI is recommended.)
-
Check whether or not fees should be subtracted from the amount you are sending.
-
Optionally, you can enter a comment, e.g. "Sending 5 CHI to Alice".
-
Click SEND.
You can check your transaction on the Transactions screen.
DO NOT TYPE ADDRESSES.
Typing address is highly discouraged. You could make a simple mistake, and lose your CHI.
We STRONGLY recommend copying and pasting addresses.
The Send screen is not for transferring names. See Transferring a name for more information.
— Top — Overview — Receive — Send — Transactions — Create Names — My Names — Settings — Console — Exit —
The Transactions screen has a complete record of your transaction history.
The relevant fields are:
- Address: The address in your wallet involved in the transaction.
- Name/Label: If the transaction was for a name, then relevant name information is displayed here. Often these are game moves.
- Category: This tells you whether you sent or received CHI, as well as whether the coins are generated (mined).
- Amount: This is the amount of CHI. Sent CHI are negative, and received CHI are positive.
- Date: This is the date and time of the transaction in YYYY-MM-DD HH:MM:SS format.
- Confirmations: This is the number of confirmations for the transaction. Loosely speaking, this is how many blocks have been mined since then.
Once you scroll to the bottom, you can click the PREV or NEXT buttons to view more transactions.
— Top — Overview — Receive — Send — Transactions — Create Names — My Names — Settings — Console — Exit —
Creating names is one of the most important aspects of the wallet. Here you can create names for accounts that you use for different games.
To create a name for use as an account for games:
-
Choose the "p/" namespace from the Select preset namespace drop-down menu. This is for reserving account names.
-
Type a name in the Name input.
-
Leave the Name Value input empty.
-
Click SUBMIT NAME.
You can check your acount name on the My Names screen.
This is not the actual name of your game. XAYA uses "name" as jargon. Here, a "game name" is more traditionally best described as a "game ID".
To create a name for use as game name:
-
Choose the "g/" namespace from the Select preset namespace drop-down menu. This is for reserving game names.
-
Type a name in the Name input as shown above.
-
Leave the Name Value input empty.
-
Click SUBMIT NAME.
You can check your game name on the My Names screen.
Custom namespaces are reserved for further development.
There is little to no point in reserving a name in a custom namespace. Some developers may find a use, but are discouraged from using custom namespaces without serious consideration.
— Top — Overview — Receive — Send — Transactions — Create Names — My Names — Settings — Console — Exit —
The My Names screen lists all of the names that you've reserved for yourself. The following example has 1 name, but you could have many more.
There are 4 columns:
- XAYA Name: This is the proper name that you've reserved.
- Name Value (optional): This is simply the JSON expression of your name.
- Address: This is the CHI address for your name.
- Update/Transfer: This allows you to change the properties of your name or to transfer your name (account) to someone else.
Unless you fully understand what an update is, you should NOT update your name. Updating names is an advanced feature meant for experts.
You can transfer a name to someone else by sending the name to a valid CHI address.
-
Click TRANSFER for the name you wish to transfer.
-
Paste in the CHI address that you want to transfer the name to.
-
Click OK.
The name is transferred to the address. You can check the transaction on the Transactions screen.
— Top — Overview — Receive — Send — Transactions — Create Names — My Names — Settings — Console — Exit —
The Settings screen lets you change connection settings, back up your wallets, and switch to testnet.
Advanced users can change connection settings.
Unless you fully understand the connection settings, you should leave them as is.
Advanced users and miners can make the changes they need, then click the SUBMIT SETTINGS button to save their new connection settings.
The DataDir Override allows you to change the directory where the XAYA blockchain, wallets, and other data is stored. The default directory is:
%APPDATA%\Xaya\
e.g. C:\Users\<user>\AppData\Roaming\Xaya
On Linux the datadir is here:
~/.xaya/
Or here:
~/home/<user>/xaya/
On OS X (Mac) the datadir is here:
~/Library/Application Support/Xaya/
People with limited space on their system drive may wish to change the datadir folder location.
You can back up your wallets by clicking the wallet backup buttons.
-
Click either of the WALLET BACKUP buttons.
-
Browse to a folder where you want to back up your wallet.
-
Accept the default backup filename (either "game.dat" or "vault.dat"), or enter a name for your backup as illustrated in the figure above.
-
Click the Save button.
-
Click OK.
-
Browse to your backup in your file explorer and perform any additional backup plans you have, e.g. save it to a USB stick or external drive.
See Back Up Wallets for additional information or Manually Backing Up Wallets for how to do it manually.
If your wallet will not fully synchronise, you can click DELETE CHAIN to delete the current blockchain data and resynchronise. This should get your wallet properly sync'ing again.
Keep in mind that it can take a significant amount of time to fully resync your wallet, and largely depends on your network speed.
If you still experience problems, post in the Support forums here.
Most people have no need for testnet. Proceed with caution.
To switch to testnet, check the Testnet checkbox then click the SUBMIT SETTINGS button and restart the XAYA Electron wallet.
Testnet is used for testing. Most people have no need for testnet.
However, if you wish, you can use testnet to try out different features and become familiar with them before you "go live" and try them on mainnet.
— Top — Overview — Receive — Send — Transactions — Create Names — My Names — Settings — Console — Exit —
The console is for testing purposes only. It is provided for those who wish to get blockchain information and should not be used to write to the blockchain.
Type "help" then press Enter or click SEND for a list of commands.
Not all commands are supported in the XAYA Electron wallet. Use the XAYA QT wallet for full support.
An example of a useful command is "getmininginfo". It returns the current results, similar to the figure below.
Those wishing to perform more advanced operations should work with the XAYA daemon directly or download the XAYA QT wallet. It is similar to the Bitcoin Core wallet.
— Top — Overview — Receive — Send — Transactions — Create Names — My Names — Settings — Console — Exit —
The Exit menu item shuts down the XAYA Electron wallet and the XAYA daemon.
You must have the daemon running in order to play games or interact with the XAYA blockchain. The wallet is a convenient GUI wrapped around the daemon.
— Top — Overview — Receive — Send — Transactions — Create Names — My Names — Settings — Console — Exit —