Month: February 2018

Issues switching from remote node back to local using

In you have been using the remote node in combination with the official Qwertycoin Desktop you may experience issues when switching back to local or automatic mode. It most cases the application will crash and a simple restart will solve the issue.

Some users report that restarting the wallet application results in yet another crash. If your get stuck in this loop don’t worry there is a simple fix using any text editor of your choice.

  1. Browse to you Qwertycoin data folder. Default on Windows is something like C:\Users\\AppData\Roaming\qwertycoin
  2. Open the GUI configuration file qwertycoinwallet.cfg using Notepad or any other editor
  3. Change the connectionMethod value to
    1. to use the Embedded node (default)
    2. to use the Local Daemon
    3. to use the configured remote node

That’s it. Start your wallet and things should be back to normal.


Daemon Config Manual

Qwertycoind can accept settings through a configuration file. This is the output of daemon’s help command on acceptable parameters:

all of the command line options can be defined through the configuration file.

Command line options:
  –help Produce help message
  –version Output version information
  –os-version
  –data-dir arg Specify data directory
  –config-file arg(=qwertycoin.conf) Specify configuration file
Command line options and settings options:
  –log-file arg
  –log-level arg (=0)
  –no-console Disable daemon console commands
  –rpc-bind-ip arg (=127.0.0.1)
  –rpc-bind-port arg (=8197)
  –p2p-bind-ip arg (=0.0.0.0) Interface for p2p network protocol
  –p2p-bind-port arg (=8196) Port for p2p network protocol
  –p2p-external-port arg (=0) External port for p2p network protocol (if port forwarding used with NAT)
  –allow-local-ip Allow local ip add to peer list, mostly in debug purposes
  –add-peer arg Manually add peer to local peerlist
  –add-priority-node arg Specify list of peers to connect to and attempt to keep the connection open
  –add-exclusive-node arg Specify list of peers to connect to and attempt to keep the connection open
  –seed-node arg Connect to a node to retrieve peer addresses, and disconnect
  –hide-my-port Do not announce yourself as peerlist candidate
  –extra-messages-file arg Specify file for extra messages to include into coinbase transactions
  –start-mining arg Specify wallet address to mining for
  –mining-threads arg Specify mining threads count

If a parameter is defined in the config and was also indicated in the command line, two behaviors are possible. If the parameter accepts one value only (e.g., rpc-bind-ip), the command line value will be used, since it has a higher priority. If the parameter accepts several values (e.g., add-priority-node), then command line and configuration file values will be merged.

By default config file’s name is “qwertycoin.conf”, which is located in the binaries folder. However, you may adjust the destination to the file via “–config-file” option in the command line.

If some of the options are not defined in the config, the default values will be applied. Here’s the example of a possible configuration file:

log-level=4
no-console=yes

rpc-bind-ip=0.0.0.0
rpc-bind-port=8197
p2p-bind-ip=0.0.0.0
p2p-bind-port=8196
p2p-external-port=81960

allow-local-ip=yes

add-peer=1.1.1.1:8196
add-peer=1.1.1.2:8196
add-peer=1.1.1.3:8196

seed-node=2.2.2.2:8197
seed-node=2.2.2.2:8197

hide-my-port=no

start-mining=QWC1L4aAh5i7cbB813RQpsKP6pHXT2ymrbQCwQnQ3DC4QiyuhBUZw8dhAaFp8wH1Do6J9Lmim6ePv1SYFYs97yNV2xvSbTGc7s
mining-threads=4

Blockchain Installation

To synchronize your Qwertycoin software with the network faster, you may download blockchain file.

  1. Unpack the downloaded blockchain archive.
  2. Move the extracted files blockindexes.dat and blocks.dat to the standard Qwertycoin folder (replace existing files if necessary):

Windows:

C:\Users\%user_name%\AppData\Roaming\qwertycoin\

OSX/Linux:

~/.qwertycoin/

Relaunch your Qwertycoin software.


Reference Client Manual

Qwertycoin works through 2 separate binary files operated through command line:

  1. qwertycoind– daemon to synchronize the blockchain and mine qwertycoin.
  2. simplewallet – wallet to receive and send funds.

Install Qwertycoin

  1. Unzip the archive to one separate folder
  2. Download blockchain archive and unpack it to:

Windows:

C:\Users\%user_name%\AppData\Roaming\qwertycoin\

OSX/Linux:

~/.qwertycoin/

Launch Qwertycoin

  1. Open qwertycoind. For downloadable Linux archive use ./qwertycoind.
  2. Wait until qwertycoind is synchronized. You will be notified with several green “SYNCHRONIZED OK” messages.
  3. Open simplewallet. For downloadable Linux archive use ./simplewallet.

Daemon: synchronization & mining

After qwertycoind is launched you will have to wait until it is synchronized with the network. You will be notified with several green “SYNCHRONIZED OK” messages. Here are the most important daemon commands:

start_mining [threads=1] Start mining in several threads to a given wallet address
stop_mining Stop mining
show_hr Show current mining hashrate
hide_hr Stop showing current mining hashrate
help Show all daemon commands
exit Exit qwertycoind

Wallet: send and receive payments

Simplewallet can only be used after the daemon is launched and synchronized. Simplewallet automatically synchronizes with qwertycoind. Here are the most important wallet commands:

address Show your wallet address
balance Show current wallet balance
transfer

Send money to

with a mixing amount of
start_mining Start mining in daemon with several threads to the current wallet address
stop_mining Stop mining in daemon
help Show all wallet commands
exit Exit simplewallet

Qwertycoin Wallet Manual

Once you open Qwertycoin Wallet, it will automatically create your first Qwertycoin address and start synchronizing with the network.

It is highly recommended that you encrypt your new wallet with a password. Leaving the wallet unprotected makes it vulnerable in case your system is compromised.

To encrypt your wallet, choose “Settings” menu and then “Encrypt wallet”.

Wallet file format

Unlike Qwertycoin Reference Client, Qwertycoin Wallet uses .wallet files instead of legacy .keys files to store your private keys for each wallet.

Qwertycoin Wallet is able to import .keys files (with the existing password), but it will create a .wallet file for further operations.

Qwertycoin Wallet files

Qwertycoin Wallet introduces several new files stored in the standard Qwertycoin folder:

Windows:

C:\Users\%user_name%\AppData\Roaming\qwertycoin\

OSX/Linux:

 ~/.qwertycoin/

The most commonly used files are the following:

  • qwertycoinwallet.wallet – a default wallet keys file that is created on first startup of Qwertycoin wallet and gives access to your fresh Qwertycoin address.
  • qwertycoinwallet.log – a log file for the node that is running inside Qwertycoin Wallet.