Ballzcoin Wallets and Client Binaries

This page includes links to the Web Wallet download, GUI wallet, client binaries (incorporating the command line wallet), MyEtherWallet instructions, instructions for creating accounts, sending coins and backing up your account.

Summary

There are three wallet options: Web wallet, GUI wallet, and command line wallet. The web wallet is hosted at https://wallet.ballzcoin.org and can also be downloaded using the link below and run from your own computer. You can also use MyEtherWallet directly, with a public Ballzcoin node (see instructions at the bottom of the page).



Download Links

To create an account, first download a wallet. Beginners are advised to use the Web Wallet or GUI wallet. For security reasons, only download files from these links here! Do not download from any third party websites. Or if you are comfortable building from source, download the source from the github repository.

Web Wallet Download

Linux GUI Wallet

Windows GUI Wallet

Linux Client Binary

Windows Client Binary

The current versions are 1.0 for the web wallet, 0.0.4 for the GUI wallets, and 1.8.12 for the client binaries.



Web Wallet Instructions

After downloading, extract the contents of the zip file into a new directory. Open 'index.html' in your browser. Usage is the same as MyEtherWallet:

  • To create a new wallet, navigate to 'New Wallet' and follow the instructions.
  • Then navigate to 'Send Ballzcoin & Tokens' to start sending Ballzcoin and checking your balance. To get your address for the first time, you will need to unlock your wallet.


GUI Wallet Instructions

After downloading, extract the contents of the zip / tar file into a new directory. Then double click on Ballzcoin-Ballzbrowser-Wallet.exe (Windows) or ballzcoin-ballzbrowser-wallet (Linux). The wallet should start up, and after a few seconds start synchronising with the blockchain.

There is a known issue on some PC's which prevents the GUI wallet from starting, giving the error 'Ballzcoin node connection error' on the splash screen. For a workaround, see below.

To create a new account, click on the 'ADD ACCOUNT' button and follow the prompts. Use a strong but memorable password. There is no password recovery function in Ballzcoin, so be careful! Remember to backup your account (see below).

To send coins to another account, click on the 'SEND' button and fill in the form.



GUI Wallet Known Issues

There are two known issues with the wallet, which is still beta software.

The first issue affected some users who downloaded the wallet at initial release (version 0.0.3). There was a bug in the wallet that would sometimes prevent coins from being sent if the network gas price was very low. For any users experiencing this problem, download the latest wallet and follow the instructions on this Github issue page to unfreeze your transactions, if required.

The second issue affects some users and not others, and has so far only been reported on Windows PC's. If you get 'Ballzcoin node connection error' when starting up, follow one of the two workarounds below:

Workaround 1

  • Close the wallet.
  • Check the file size for 'ballzcoin.exe' in the following folder: C:\Users\your.username\AppData\Roaming\Ballzcoin-Ballzbrowser-Wallet\binaries\ballzcoin\unpacked
  • If the file size is 0MB, delete the exe file (don't delete anything else!).
  • Download the Windows client binary in the announcement post, extract, and copy ballzcoin.exe to the folder to replace the deleted file.
  • Start the wallet.

Workaround 2

If the above workaround doesn't solve the issue, try this:
  • Close the GUI wallet.
  • Run the client binary in console mode (see instructions below).
  • Wait for the client to sync and download the blockchain.
  • Run the GUI wallet. The wallet should load up.
  • After closing the GUI wallet, the correct way to exit the client is by typing 'exit' into the console.



Backup your Accounts

It is very important to backup your account. The account file is an encrypted private key, stored on your computer. If this is deleted, your coins will be lost forever! The same applies if you forget your password. There is no password recovery function!

To backup your accounts, simply copy and paste the encrypted account files to another location (for example an external hard drive, optical media, USB drive, etc). It is safest to have at least two separate backups, preferably stored in different physical locations. The default account file locations are here:

Windows:

C:\Users\your.username\AppData\Roaming\Ballzcoin\keystore

Linux:

/home/yourusername/.ballzcoin/keystore



Command Line Wallet Instructions

This option is a little less user friendly than the above options, and is meant for users who are comfortable with command line applications. The command line wallet is built into the client binary (also known as the node). For users familiar with Geth (Go Ethereum), all commands are identical. Just substitute 'ballzcoin' for 'geth'!

Running the client in Windows:

  • Download and unzip the client to a new folder.
  • Click the Start button.
  • Type 'cmd' to open the command prompt.
  • Change directory to wherever you installed the client (for example, if you installed in C:\Users\your.username\Ballzcoin, just type 'cd/ballzcoin').
  • To run the client, type 'ballzcoin console'.
  • The client will start up. Within 15 seconds, you should get the message 'Block synchronization started', followed by a number of messages one after the other saying 'Imported new chain segment Blocks = x', where x is a number between 1 and 2048.
  • When x has dropped down to 1, synchronization is complete!
  • When you want to exit the console, type 'exit'. It is best to do this rather than just closing the terminal, as there is a risk of data corruption.



Running the client in Linux:

Follow the instructions above, but open a terminal in the directory where you have extracted the client, and type './ballzcoin console'.

Creating a new account from the console:

  • Create a new account by typing 'personal.newAccount()'.
  • Enter a password. Remember: there is no 'forgotten password' option. If you forget the password, you lose access to your account forever!
  • Your account address will be displayed on the console (e.g. “0x123456789abcdefg etc”). Write it down. You can always get it to display again using the following command: 'personal.listAccounts'.

Send coins:

To send coins from one account to another from the console, type the following commands, replacing the example account numbers with your account (from:) and the recipients account (to:) and the amount (10 Ballzcoin in the example below).

  • personal.unlockAccount("0x123456789abcdefg etc")
  • Enter your password
  • eth.sendTransaction({from:"0x123456789abcdefg etc", to:"0x123456789abcdefg etc", value: web3.toWei(10, "ether")})



MyEtherWallet Instructions

MyEtherWallet has a feature that allows it to be used with any Ethereum based cryptocurrency, or for private blockchains. It is called Custom Node. To use it for Ballzcoin, follow these instructions:

1. Visit https://www.myetherwallet.com. Make sure you are on the official page and not a phishing site! Is the padlock on the URL bar closed? Good. Did your browser give you any security warning messages? If so, stay away!

Alternatively to avoid any worries about phishing, download the distribution from https://github.com/kvhnuke/etherwallet/releases and run it on your own machine (unzip to an empty folder, and open index.html in your browser. It's as easy as that!)

2. Create a new account by following the MyEtherWallet instructions, if you don't have one already.

3. Click on the Network dropdown box on the top right hand corner of the website, and select 'Add Custom Network / Node"



4. Add the Ballzcoin public node parameters into the box:

  • Node name: Ballzcoin (or whatever you want!)
  • URL: https://node.ballzcoin.org
  • Port: 443
  • Check 'Custom'
  • Tick 'Supports EIP-155'
  • Chain ID: 2025418852



5. Click 'Save & Use Custom Node'. A message should come back confirming that you are connected:



6. Success! You can use MyEtherWallet by navigating to 'Send Ether and Tokens' and selecting 'Keystore / JSON File'. As stated in point 1, for better security, it is highly recommended to run MyEtherWallet off your machine, rather than the web. For very high levels of security, run it off a machine that is not connected to the internet (and never will be), and then broadcast the raw transaction using a connected copy of MyEtherWallet (navigate to 'Send Offline').

7. Did a red error message pop up saying you are not connected? Double and triple check the parameters entered into the custom node box. If you still can't connect, come and report it in the help channel on The Ballzcoin Discord Server.

8. Why should you trust https://node.ballzcoin.org? You don't have to! The MyEtherWallet javascript handles the private key, signs the transaction, and then broadcasts the raw transaction to the node using a JSON RPC call. Your private key and password are not sent to the node.