Skip to content

Latest commit

 

History

History
62 lines (43 loc) · 5.46 KB

wallet-guide-windows.md

File metadata and controls

62 lines (43 loc) · 5.46 KB

MaxCoin wallet usage in Windows

The MaxCoin wallet is supplied in both graphical and command-line form. This file provides instructions for using both wallets. Also included is an example maxcoin.conf file. This allows the wallet to initially synchronise with the network, along with allowing configuration options to be specified by advanced users. The RPC username and password fields MUST BE CHANGED for your security.

For both users of Windows 7 and 8, this should be placed in C:\Users<username>\AppData\Roaming\MaxCoin\maxcoin.conf.

Installation

To install the wallet, simply copy the contents of this folder to any location you desire on your computer. You can create a desktop shortcut by right-clicking on maxcoin-qt.exe and selecting Send > To desktop (create shortcut).

Upgrading your wallet

If you are upgrading from a previous version of MaxCoin, you'll need to ensure you make a back up of your wallet file. This is located at C:\Users<username>\AppData\Roaming\MaxCoin\wallet.dat. Make a copy of this and store it in a safe location - this is the file that allows you to access your coins, it contains your private keys - in the unlikely event that something goes wrong with the install, you'll need this. Now, install the new version as per the instructions above. This should overwrite the existing version, whilst keeping the data intact. Finally, run the wallet and confirm that the update has occurred by viewing the version in the Debug window (Help > Debug window). It should read v0.9.0.0-xxxxxxxx-beta.

If you find you no longer have access to your old addresses or coins, copy the wallet.dat file back to the original location, C:\Users<username>\AppData\Roaming\MaxCoin, and restart your MaxCoin wallet.

Graphical wallet (maxcoin-qt.exe)

The graphical wallet can be run by double-clicking on maxcoin-qt.exe. A splash screen should display the loading status of the wallet.

Use of the graphical wallet is fairly self-explanatory. The balance, along with recent transactions, can be seen in the Overview page. You can send and receive coins using their respective pages, specifying an address manually or using an address from the address book, found in the Addresses page. A complete list of transactions can be seen in the Transactions page.

To mine using the graphical wallet, the Mining page is used. You can specify two modes here, Solo or Pool. Solo mining uses an inbuilt CPU miner to try and find blocks - the chances of this happening are very slim however, and it isn't recommended. Pool mining uses the minerd.exe CPU miner (available from here) to mine using a mining pool (see here for a list of mining pools). The miner receives a share of work from the pool and, in exchange, will receive a proportional quantity of MaxCoins when a block is found.

Command-line wallet (maxcoind.exe)

The command-line wallet can be run by typing maxcoind into a command-prompt when in the same directory as maxcoind.exe. You can optionally add the directory to the PATH environment variable so this can be run anywhere. Double-clicking run.bat will open a command prompt in the current directory.

To use the command-line wallet, a second command-prompt is used, also in the same directory as maxcoind.exe (or by double-clicking run.bat). This second command-prompt can then be used to issue commands to the wallet by typing maxcoind COMMAND [OPTIONS]. Typing maxcoind help will display a full list of available commands.

Common commands are:

  • getbalance [account] - displays the balance of your MaxCoin wallet or, optionally, an account
  • getnewaddress [account] - creates a new MaxCoin address and optionally adds it to an account
  • backupwallet - backs up the wallet to a specified destination
  • getccount - returns the account an address belongs to
  • getaccountaddress - returns the current MaxCoin address for an account
  • getinfo - displays information about the wallet and the network
  • getpeerinfo - displays information about connection nodes on the network
  • getmininginfo - displays information related to mining MaxCoins
  • setgenerate <true|false> [processlimit] - turns on or off mining
  • stop - shuts down the MaxCoin wallet
  • walletpassphrase - unlocks an encrypted wallet for a specified number of seconds
  • walletlock - locks an encrypted wallet
  • validateaddress - returns information about a specified address
  • sendtoaddress [comment] - sends MaxCoins to an address
  • listaccounts - displays accounts within the wallet
  • listreceivedbyaccount - lists the received transactions, grouped by the account
  • listreceivedbyaddress -lists the received transactions, grouped by the address

Advanced commands are:

  • makekeypair - generates a public-private keypair for MaxCoin address creatio
  • signmessage
  • verifymessage

A list of commands for Bitcoin can be found at https://en.bitcoin.it/wiki/Original_Bitcoin_client/API_calls_list. A MaxCoin-specific list is being compiled and will be available soon.