FAQ Overview

Depending on your internet connection, ColossusXT blockchain synchronization within the wallet application can take a considerable amount of time. This is by design: synchronization speeds are intentionally throttled to prevent oversaturation of the ColossusXT network and maintain high availability at all times.

The ColossusXT team has provided an archived copy of the blockchain database, which can be download via a web browser in just a few minutes. Once downloaded, the database can be extracted and inserted into the ColossusXT wallet folder, allowing users to get their wallet application fully synchronized much more quickly. This process is often referred to as "bootstrapping the database".

This guide can be used for Windows, Mac, or Linux. The process is very similar on all OSes.

NOTE: In ColossusXT wallet versions 1.2.0 and higher, you can now bootstrap automatically from the cloud using an in-wallet option! This is a much quicker and easier process than this manual bootstrap process, which is only needed if the wallet application will not open. To use automatic in-wallet cloud-based bootstrapping, follow this guide instead.

Verify That 1.2.4 Is Installed.

Windows: In the wallet application, click Help > About ColossusXT Core. Verify that version 1.2.4 is installed.

Mac: On the wallet application menu bar, click COLX Core > About COLX Core. Verify that version 1.2.4 is installed.

If you have an older Windows or Mac version, see the Windows / Mac 1.2.4 Wallet Install / Update Guide here.

Linux: From the ColossusXT program folder, type ./colx-cli getinfo and verify that "version" is "1020400".

If you have an older Linux version installed, see the Linux / VPS 1.2.4 Wallet Update Guide here.

Close The ColossusXT Program

Clicking the "X" in the upper corner does NOT close the wallet application by default; it only minimizes it!

Windows: Click File > Exit in the wallet application.

Mac: Click COLX Core > Quit COLX Core.

Linux: Use the command ./colx-cli stop

Download The Bootstrap Archive 

For Windows and Mac, you can download the bootstrap archive file using your web browser by visiting bootstrap.ColossusXT.io. Your download will begin automatically.

In Linux, you'll need to use the wget command:

wget -O ~/Downloads/COLX_Bootstrap.zip http://bootstrap.colossusxt.io/COLX_Bootstrap.zip

Delete Existing Files

WARNING: Never delete your wallet.dat!

Windows: Press Windows + R, type %appdata%\ColossusXT, and click OK. Keep your backups folder and your wallet.dat. If this is a masternode control wallet, also keep your masternode.conf. Delete everything else. Leave this folder open for the next step.

Mac: Press Command + Shift + G, enter ~/Library/Application Support/ColossusXT and click on Go. Keep your backups folder and your wallet.dat. If this is a masternode control wallet, also keep your masternode.conf. Delete everything else. Leave this folder open for the next step.

Linux: Enter the following commands:

cd ~/.ColossusXT
rm ColossusXT.conf
rm mncache.dat
rm peers.dat
rm budget.dat
rm banlist.dat
rm -rf blocks
rm -rf database
rm -rf chainstate
rm -rf sporks
rm -rf zerocoin

Extract Archive

Windows & Mac: Open the archive from your web browser downloads. Copy the ColossusXT.conf file, and the blocks, chainstate and  zerocoin folders from the archive and paste them into the open folder from the previous step.

Linux: Use the following command:

unzip ~/Downloads/COLX_Bootstrap.zip -d ~/.ColossusXT 

If you get "command not found", you'll need to install the unzip program first:

apt install unzip

Using a Linux text editor such as pico, change the default rpcuser and rpcpassword settings in the ColossusXT.conf to your own random letters and numbers.

pico ~/.ColossusXT/ColossusXT.conf

 Make your changes, press Ctrl+X to exit, press Y to save, and press Enter to retain the original filename.

Note for Masternodes: If this is a Masternode system, you'll also need to add the following lines to your server wallet's ColossusXT.conf:

masternode=1
daemon=1
port=51572
externalip=<your masternode IP>
masternodeaddr=<your masternode IP>
masternodeprivkey=<your masternode privkey>

Your masternode privkey can be copied from your local wallet masternode.conf. It is the long string immediately after the IP:Port entry.

Restart Wallet

You can now restart your ColossusXT wallet application. Synchronization will begin from a recent block, rather than from 2017, and will complete within a few minutes.

Windows & Mac: Click the ColossusXT wallet shortcut

Linux: Use the following commands:

cd ~/colx-1.2.4/bin
./colxd

Additional Resources

As always, if you have any questions, please come find us in the #general-support channel of the ColossusXT discord:

http://discord.colossusxt.io

You can use the COLX Staking calculator here:
https://calculator.colossusxt.io/staking

The formula:

T = the Total number of COLX currently staked. Current number is 2.24 billion (June 26th 2018)
P = your Personal number of COLX staked.
1440 = The number of blocks in a day
T / (P * 1440) = your average number of days per reward

Try below in order and move on to the next step if your issue is not solved:

1) Right-click the task bar and click "Cascade Windows". Check if you can see the wallet.

2) On Windows:

• Exit wallet
• Run "regedit" (Press "Windows" and "R" keys together, it will open a run window, write "regedit" there and click "OK")
• Delete this reg key:
  HKEY_CURRENT_USER\Software\ColossusXT\ColossusXT-Qt\nRPCConsoleWindowPos
• Restart the wallet and the window position should be fixed.

On Mac:

• Exit wallet
• Open Terminal
• cd ~\Library\Preferences
• rm io.http\:\ \ colossusXT.ColossusXT-Qt.plist
• Restart the wallet and the window position should be fixed.

Please refer to the exchanges page on our website for the updated list of exchanges you can acquire COLX: https://colossusxt.io/exchanges

NOTE: Wallet versions older than 1.0.4 use the name "ColossusCoinXT" rather than "ColossusXT" for the COLX folder and config file. Substitute as needed, and update your wallet as soon as possible.

First, close your COLX wallet application.

Next, open your ColossusXT folder:

For Windows: Press Windows + R. This will open the Run window.
Paste this and click OK %appdata%\ColossusXT
For Mac: Press Command + Shift + G. This will open the "Go to" window.
Paste this: ~/Library/Application Support/ColossusXT/

Next, locate the wallet.dat file in the ColossusXT folder, and rename it to wallet.old. Then, copy the wallet.dat from your backup folder into this folder. Next, relaunch the COLX wallet application. Wait for the wallet to synchronize. If your COLX does not appear, click on Tools, Wallet Repair, and click the button that says "Rescan blockchain files". This will automatically close and relaunch your wallet. Wait for the wallet to complete the rescan, and synchronize. If your COLX still does not appear, click on Tools, Wallet Repair, and click the button that says "Recover transactions 1". This will automatically close and relaunch your wallet. Wait for the wallet to complete the recovery and synchronize. Your COLX should now be available.

Now that the maturity requirement for staking COLX has been reduced from 7 days to 8 hours, splitting coins is no longer necessary to optimize your staking rewards.

The best way to resolve this issue is to follow the ColossusXT Bootstrap Guide to reset your blockchain to a more recent state.

Follow the instructions here: ColossusXT Bootstrap Guide

This issue occurs when the system clock is not properly synchronized.

For Windows 10: Click on Start, then type "time", and select "Change the date and time." Make sure "set time automatically" is checked.

For Windows 7: Double-click the clock in the lower right corner of the screen. Click "Change date and time settings". Click the "Internet Time" tab and make sure internet time is enabled.

For OSX: Click System Preferences, then Data and Time. Make sure "set date and time automatically" is checked. You will need to click the lock icon to make changes.

In the debug console, type getblockcount. This will tell you the newest block in your wallet. Then type getblockhash followed by that block number.

Now visit the COLX Blockchain Explorer and search for that same block number. The blockhash displayed should match the hash from your console:

If it matches, you are good to go.

If it does not match, the best way to resolve this is by following the ColossusXT In-Wallet Bootstrap Guide.

If you receive this error when you think you already completed all previous steps, open the local wallet debug console and use the following command to start your MN manually:
masternode start-alias "your MN name"

If above solution does not help you, check previous steps in MN guide starting by checking if masternode outputs command gives you a result in debug window where the result should match with the details in "masternode.conf" file.

If a wallet is selected to generate the next new block (which will result in a staking reward) but does not complete this task in time, the new block will be orphaned and the task will be completed by another staking wallet. Thus, less responsive systems with a slower network connection and/or less available system resources will tend to generate more orphan blocks over time. If you have not updated to the latest wallet, you may see an increased number of orphans. Orphan blocks are a normal occurrence on a blockchain.

Some suggestions if you keep seeing orphan blocks:

• Always check wallet version first, get the latest one (In the wallet app, click on Help > About ColossusCoinXT to check version)
• Try to use a cable connection (instead of wifi) if possible
• Check power settings. Make sure the computer is not going for sleep
• Reboot your pc if it was open for a long time
• Terminate some application which are eating up resources if possible

Click the Start Button.
For Windows 7, type "Folder Options".
For Windows 10, type "File Explorer Options". Click the icon to launch. Click the View tab, then scroll down to "Hide extensions for known file types". Uncheck the box, and click OK.

Your shared masternode rewards will be equal to your share of a daily masternode reward, proportional to your percent stake in the masternode, minus StakingLabs' 5% fee.

Stakinglabs Shared Masternode Rewards Calculator: https://colx.ciwox.com/calculator-shared-mn

It can be calculated as follows:
(B / N) * R * (P / M) * (1 - F) = A B = blocks per day (1440)
N = current number of masternodes (currently 216)
R = current masternode block reward (570)
M = number of coins required for MN (10,000,000)
P = personal coins in shared masternode
F = Stakinglabs fee (5% or .05)
A = average masternode rewards earned per day

Example: If I have 750,000 coins on Stakinglabs, I will earn 270.5 COLX per day on average: (1440 / 216) * 570 * (750,000 / 10,000,000) * (1 - .05) = 270.5

ColossusXT is an anonymous blockchain through obfuscation, Zerocoin Protocol, along with utilization of I2P. These features will protect end user privacy as ColossusXT evolves into the Colossus Grid. The Colossus Grid will connect devices in a peer-to-peer network enabling users and applications to rent the cycles and storage of other users’ machines. This marketplace of computing power and storage will exclusively run on COLX currency. These resources will be used to complete tasks requiring any amount of computation time and capacity, or allow end users to store data anonymously across the COLX decentralized network. Today, such resources are supplied by entities such as centralized cloud providers which are constrained by closed networks, proprietary payment systems, and hard-coded provisioning operations. Any user ranging from a single PC owner to a large data center can share resources through Colossus Grid and get paid in COLX for their contributions. Renters of computing power or storage space, on the other hand, may do so at low prices compared to the usual market prices because they are only using resources that already exist.

First, back up your wallet.dat, then follow the bootstrap procedure in the following link: ColossusXT Bootstrap Guide

66 TPS

ColossusXT Linux / VPS Wallet 1.2.4 Setup Guide

Security Advisory

Please use common sense and security best practices when working with other people to help configure and troubleshoot your wallet!

Scammers often pose as team members or "tech support". All official ColossusXT team members have custom colored names in the ColossusXT Discord.

Never share your keys, passwords, or wallet files with anyone. Never install third-party software or allow people to remotely control or view your system.

Remember, where there is money there are thieves!

Before we begin, if you’re new to Linux, it’s recommended that you become familiar with the basic commands. Here is a good cheat sheet to get you started.

First, a few quick bits of information you’ll need for this guide:

1. All Linux commands are CASE SENSITIVE. ALWAYS pay close attention to case.
2. The ~ symbol is a shortcut to the current user’s home folder, which is /root for the root login, and /home/username for any other user’s login. You will see this very often. It is not a random squiggly mark; it has a specific and important meaning.
3. Just like on Windows and OSX, the Linux COLX program folder (~/colx-1.2.4) will be different than the COLX wallet folder (~/.ColossusXT). The program folder contains the executable application files, while the wallet folder contains your wallet.dat file and your local copy of the COLX blockchain database.

Note: This guide is for a NEW install only! If you are updating from a previous version, please use the Linux / VPS Update Guide instead. It will be much quicker!

Connecting To Linux / VPS

Most VPS services come with a web-based console that lets you connect to your VPS without installing any additional software. However, many users prefer to install third-party software to connect to their VPS remotely.

For Windows, the most common Windows software to connect to a VPS is PuTTY. It is available for download here. Download and run the MSI installer, then run the PuTTY application. Enter the IP of your VPS, select port 22 and SSH, and click Open. You can also optionally click Save on this screen so that your Putty application will automatically open with these settings in the future.

The first time you connect with Putty, you will receive a Security Alert. Click Yes to this alert to continue to a login prompt.

Enter the your login credentials to log in. No characters will be displayed while you enter your password.

PuTTY Usage Note: To copy-paste into the PuTTY window, copy the text you wish to paste, then right-click in the PuTTY window. The text will be pasted at the location of your text cursor.

For OSX, a Terminal application is already built in and there is no need to install additional software like PuTTY. On OSX, Search for the “Terminal” application in Spotlight search or your applications menu. Use the ssh command along with your username and IP address to log in to your system:

ssh username@123.234.123.234

You will see a similar one-time security warning. Type “yes” to continue:

For Linux, use the above ssh command to connect from your Linux terminal

Linux / VPS Password Security

Use a long, strong, and unique password. Your password should be at least 20 characters. Your password should not be in any dictionary. It should contain uppercase and lowercase letters, numbers, special characters, etc. Don't use obvious substitutions like 0 for O or 5 for S. Don't use a password that you use anywhere else, or even a password similar to one you use elsewhere.

To change your password, use the passwd command after logging in.

Linux / VPS Additional Security Options

Because Linux / VPS systems are generally always online, some users opt to take additional security precautions to protect their system from attacks and intrusion. If you're using your Linux wallet to hold and stake coins, here are some optional security steps you can consider taking to improve the security of your wallet:

Disable root Login: Some users choose to disable SSH login for the default root account, and create a new account for SSH access. Here is a good guide on setting this up.

If you disable root login, you will need to become familiar with the sudo command, which allows you to run commands as root while logged in as another user. You will need to use this for any command that affects the system as a whole and requires root access. For example, when logged in as newuser, you won't need to use sudo to do things like change directories (cd), list files (ls), download files (wget), or launch ColossusXT apps (./colxd). However, to reboot (reboot) or change firewall settings (ufw), you'd need to use sudo reboot or sudo ufw.

This guide is written with the assumption that you are logged in as root.

Install a Firewall: A good option to protect your system from attacks including Denial of Service (DoS) is to install a firewall. The most common one for Linux is Uncomplicated Firewall, or ufw. In fact, depending on which Linux distribution you choose to use, this may already be installed. To check if ufw is installed, type ufw status at the command prompt. If it says "command not found", it's not installed yet.

If ufw isn't installed, use the command apt-get install ufw to install it. Remember, if you disabled root SSH login and are logged in as a different user, you'll need to include the sudo command (sudo apt-get install ufw).

 Once ufw is installed, configure it with the following commands:

ufw allow 51572/tcp  (to open the port used by your server wallet)
ufw allow 51573/tcp  (to open the RPC port used by your server wallet)
ufw allow ssh        (to allow SSH login and prevent locking yourself out!)
ufw enable           (to enable the firewall)

If you're having network connectivity issues and want to check if the firewall is the problem, you can use the command ufw disable to see if that fixes your problem.

For more information, a good starter guide to ufw can be found here.

Download The 1.2.4 ColossusXT Wallet Program From Github

Use the wget command to download the 1.2.4 wallet archive directly to your ~/Downloads directory.

NOTE: There are different wallet versions available for each system architecture. If you don’t know your architecture, use the arch command:

Use only the command that matches your system architecture:

x86_64

wget -P ~/Downloads https://github.com/ColossusCoinXT/ColossusCoinXT/releases/download/v1.2.4/colx-1.2.4-x86_64-linux-gnu.tar.gz

i686

wget -P ~/Downloads https://github.com/ColossusCoinXT/ColossusCoinXT/releases/download/v1.2.4/colx-1.2.4-i686-pc-linux-gnu.tar.gz

ARM

wget -P ~/Downloads https://github.com/ColossusCoinXT/ColossusCoinXT/releases/download/v1.2.4/colx-1.2.4-arm-linux-gnueabihf.tar.gz

Extract The New Wallet Archive To Your Home Folder

 Now use the tar command to extract the archive to a new COLX folder located at /user/home/colx-1.2.4. Again, use only the command that matches your system architecture:

 x86_64
tar xvzf ~/Downloads/colx-1.2.4-x86_64-linux-gnu.tar.gz -C ~

i686
tar xvzf ~/Downloads/colx-1.2.4-i686-pc-linux-gnu.tar.gz -C ~

ARM
tar xvzf ~/Downloads/colx-1.2.4-arm-linux-gnueabihf.tar.gz -C ~

NOTE: If you download and install the wallet for the wrong architecture, you will see an error like this when you attempt to launch the wallet:

Edit the ColossusXT.conf

 Note: Older versions of the ColossusXT wallet required additional configuration for seed nodes, staking settings, etc. These have all been set as defaults and are no longer necessary.

The only thing that needs to be added to the ColossusXT.conf file is daemon=1. The daemon setting tells the system to start ColossusXT as a background process and return you to the command prompt. If you don’t use the --daemon switch when launching ./colxd and don’t have daemon=1 in your ColossusXT.conf, you will not be returned to the command prompt until you stop the ColossusXT server process by pressing [CTRL]+Z.

There are many text-based text editors for Linux. In this example we’ll use pico. Use this CASE-SENSITIVE command to open your ColossusXT.conf file in the pico editor:

pico ~/.ColossusXT/ColossusXT.conf

This will open your config file in the text editor. Add the following line of text:

daemon=1

When you are done, press [CTRL]+X to exit.

 Press Y at the “Save modified buffer?” prompt:

Then press [Enter] to retain the original filename and exit:

The file will be saved, the editor will exit, and you will be returned to the command prompt.

Launch The COLX Wallet Application

Use the cd command to navigate to your new ColossusXT program folder and launch the ColossusXT wallet application:

cd ~/colx-1.2.4/bin
./colxd

 The console should now indicate that the server is starting:

 Now check the wallet status :

 ./colx-cli getinfo

 Check the first line for a version number of 1020400 to verify that you’re now using the 1.2.4 wallet.

Your new wallet will now begin to download the COLX blockchain. If you wait a few seconds and repeat the getinfo command, you should see that the number of blocks has increased. You can monitor this number to track your process as the block number increases toward the current block number which can be found at the COLX Blockchain Explorer.

Additional Commands For Staking

The colx-cli command is the command line version of the debug console built into the Windows and OSX wallets. Any command you’re familiar with in the GUI debug console will also work here. For example, you can use the getstakingstatus command:

./colx-cli getstakingstatus

In this case, staking status is false because there are no mature coins available, the wallet is not yet synchronized, and the wallet is not unlocked for staking.

Before you can stake, you’ll need to encrypt your wallet with the following command:

 ./colx-cli encryptwallet "password"

 After encrypting, the wallet application will close. You’ll need to restart it:

 ./colxd

 Just like on Windows and OSX, the wallet application always launches with the wallet locked, so you’ll need to unlock it before you can stake:

 ./colx-cli walletpassphrase "password" 0 true

Backing Up Your New Wallet

 After you encrypt your wallet, a new kepool is generated, so you should back it up before sending COLX to any new addresses. The easiest way to back up your wallet.dat from a remote Linux / VPS system is via a secure FTP program such as WinSCP. Install WinSCP from the link provided, then connect using your IP address, login and password. Click “Yes” on the one-time warning to accept the server’s host key.

 Once connected, you will need to press [CTRL]+[ALT]+H to enable viewing hidden files. Navigate to your remote ColossusXT directory (~/.ColossusXT) and drag the wallet.dat to your desired destination on your local file system.

Additional Wallet Commands

 The following commands are good to know for standard use of the ColossusXT wallet.

 ./colx-cli getnewaddress “Your New Address Name” to generate a new COLX address in this wallet.
./colx-cli sendtoaddress “address” amountto send COLX from your wallet to another address.
./colx-cli help to display a complete list of commands. 
./colx-cli help | more to get a complete list of commands and view it one page at a time.

Desktop Linux

 If you’re using a graphical desktop version of Linux, you can also use the Linux GUI-based COLX wallet application. Be sure to stop your text-based wallet application first:

 ./colx-cli stop

Then start the GUI-based wallet by typing:

./colx-qt

Additional Resources

As always, if you have any questions, please come find us in the #general-support channel of the ColossusXT discord:

http://discord.colossusxt.io

This guide will help you update your 1.2.3 or older Linux wallet to the latest wallet version 1.2.4. You can use this guide for any existing Linux ColossusXT wallet installation, including a local Linux install or a VPS system, for a normal Linux wallet or for a Linux masternode, and for Raspberry Pi Linux installations as well.

This guide is for updates only and assumes that you already have a previous version of the ColossusXT wallet installed! If you don't have a previous version installed, please use the ColossusXT Linux / VPS Wallet Setup Guide instead.

Linux Installation Reminders

1. All Linux commands are CASE SENSITIVE. ALWAYS pay close attention to case.
2. The ~ symbol is a shortcut to the current user’s home folder, which is /root for the root login, and /home/username for any other user’s login. It is not a random squiggly mark; it has a specific and important meaning.
3. Just like on Windows and OSX, the ColossusXT application involves two directories: A program directory, which contains the program executables, and a wallet directory, which contains your wallet.dat file, config files, and blockchain data. This guide assumes that your existing installed program directory is ~/colx-1.2.3/bin. If you installed to a different location or have a different version installed, substitute that path as needed. The wallet directory is generated automatically by old versions at ~/.ColossusXT, and should be the same on all systems. (This was previously ~./ColossusCoinXT in versions 1.0.3 and older.)

Back Up Your Wallet

The new wallet version safely uses your existing wallet files in their current location, and makes no changes to them, however, an update is a good time to back up your wallet. If you already have a known good backup, you can skip this step.

The easiest way to back up your wallet.dat from a remote Linux / VPS system is via a secure FTP program such as WinSCP. Install WinSCP from the link provided, then connect using your IP address, login and password. Click “Yes” on the one-time warning to accept the server’s host key.

Once connected, you will need to press [CTRL]+[ALT]+H to enable viewing hidden files. Navigate to your remote ColossusXT wallet directory ~/.ColossusCoinXT and drag the wallet.dat to your desired destination on your local file system.

Stop Wallet Process

Use the cd command to navigate to your old ColossusXT program directory, and then stop the server daemon process:

cd ~/colx-1.2.3/bin
./colx-cli stop

Delete Existing Program Folders

Once the server is stopped, delete any existing ColossusXT program directories:

cd ~
rm -rf colx-1.2.3

Download The 1.2.4 ColossusXT Wallet Program From Github:

Use the wget command to download the 1.2.4 wallet archive directly to your ~/Downloads directory.

NOTE: There are different wallet versions available for each system architecture. If you don’t know your architecture, use the arch command:

Use only the command that matches your system architecture:

x86_64

wget -P ~/Downloads https://github.com/ColossusCoinXT/ColossusCoinXT/releases/download/v1.2.4/colx-1.2.4-x86_64-linux-gnu.tar.gz

i686

wget -P ~/Downloads https://github.com/ColossusCoinXT/ColossusCoinXT/releases/download/v1.2.4/colx-1.2.4-i686-pc-linux-gnu.tar.gz

ARM

wget -P ~/Downloads https://github.com/ColossusCoinXT/ColossusCoinXT/releases/download/v1.2.4/colx-1.2.4-arm-linux-gnueabihf.tar.gz

Extract The New Wallet Archive To Your Home Folder

 Now use the tar command to extract the archive to a new COLX folder located at /user/home/colx-1.2.4. Again, use only the command that matches your system architecture:

 x86_64
tar xvzf ~/Downloads/colx-1.2.4-x86_64-linux-gnu.tar.gz -C ~

i686
tar xvzf ~/Downloads/colx-1.2.4-i686-pc-linux-gnu.tar.gz -C ~

ARM
tar xvzf ~/Downloads/colx-1.2.4-arm-linux-gnueabihf.tar.gz -C ~

 NOTE: If you download and install the wallet for the wrong architecture, you will see an error like this when you attempt to launch the wallet:

Launch The New Wallet Program

Navigate to the new installation directory, and launch the ColossusXT wallet

cd ~/colx-1.2.4/bin
./colxd --daemon

NOTE: "daemon" is spelled with ae not ea, and there are TWO dashes.

You will receive a message that the server is starting.

Confirm Wallet Version and Status

Check the status of your wallet to confirm that it's running the new version.

./colx-cli getinfo

Also check the block number. It will catch up to the current ColossusXT block within a few minutes. You can run the command repeatedly to monitor its progress.

Restart Masternode

If this update was for a masternode server wallet, don't forget to restart your masternode from your local wallet.

Additional Resources

As always, if you have any questions, please come find us in the #general-support channel of the ColossusXT discord:

https://discord.colossusxt.io

Security Advisory

Please use common sense and security best practices when working with other people to help configure and troubleshoot your wallet!

Scammers often pose as team members or "tech support". All official ColossusXT team members have custom colored names in the ColossusXT Discord.

Never share your keys, passwords, or wallet files with anyone. Never install third-party software or allow people to remotely control or view your system.

Remember, where there is money there are thieves!

Welcome to the ColossusXT project, and congrats on your decision to become part of the backbone of the ColossusXT currency!

This guide will help you set up your ColossusXT masternode (MN).

As you may know, the ColossusXT MN system involves two running wallets:

1. The MN server wallet. In this guide, we will refer to this as the "server wallet". This wallet is the MN’s brain, which processes ColossusXT transactions, verifies new blocks as they are created, and distributes blocks to ColossusXT users. This wallet is a server only, and holds no ColossusXT coins.

1. The local control wallet. We will refer to this as the "local wallet". The local wallet holds the 10,000,000 ColossusXT MN collateral transaction, receives MN rewards, and is used to start and stop the MN server wallet.

The most common setup for these two wallets is the local wallet installed on the MN holder’s own local Windows or OSX machine, and the MN server wallet installed on a remote Linux VPS (Virtual Private Server) using a service such as VULTR or DigitalOcean. This guide will be geared toward such a setup.

While this is the most common and convenient setup, a VPS is not required. All that is needed are two systems, capable of running a current version of the ColossusXT wallet. The local and server wallets can be Windows, OSX, or Linux, and can run on any hardware that can host these operating systems, including desktops, laptops, a Raspberry Pi, embedded Linux systems, hacked refrigerators, etc. The system requirements are very low: generally speaking, if a system can run the host operating system, it can run the corresponding ColossusXT wallet.

Before you can begin setting up your MN, the local wallet and server wallet must both be installed and synchronized. There is ample documentation on this topic, so it won’t be repeated here.

The 1.2.3 ColossusXT setup guide for Windows and OSX can be located here.

The 1.2.3 ColossusXT setup guide for Linux / VPS systems can be located here.

Once your local wallet and server wallet are installed and synchronized, you are ready to begin.

Linux / VPS System Requirements

While pretty much any Windows or OSX machine can easily run the ColossusXT wallet application, subscription-based Linux VPS services often come with a barebones configuration, and charge more for additional resources. When selecting and configuring your Linux / VPS server, we recommend the following as the minimum system requirements:

• 1 CPU core (Additional CPUs / cores will not benefit your masternode)
• At least 10GB free disk space
• 2GB or more of RAM (or equivalent swapfile configured)

Linux / VPS Password Security

Use a long, strong, and unique password. Your password should be at least 20 characters. Your password should not be in any dictionary. It should contain uppercase and lowercase letters, numbers, special characters, etc. Don't use obvious substitutions like 0 for O or 5 for S. Don't use a password that you use anywhere else, or even a password similar to one you use elsewhere.

To change your password, use the passwd command after logging in.

Linux / VPS Additional Security Options

Because ColossusXT MNs are always online, with their IP easily discoverable from the ColossusXT wallet, some users wish to take additional security precautions to protect their system.

First, let's understand the security risks: Because your MN server wallet contains no coins at any point, the risks are surprisingly minimal. There are no coins to steal! If someone gained complete control of your MN server wallet, there are really only two things they could do to impact you: Take your masternode offline, or change your MN privkey, then restart your MN from another local wallet and begin to collect your MN rewards. In either case, you would notice this quickly and could take simple steps to fix the situation. Your local wallet and 10M COLX are NEVER in jeopardy.

Here are two optional security steps you can consider to increase your server's system security:

Disable root Login: Some users opt to disable SSH login for the default root account, and create a new user account for SSH access. Here is a good guide on setting this up.

If your wallet is already installed under the root account, be sure to stop the server using the ./colx-cli stop command while logged in as root before you disable the account. You'll also need to move your ColossusXT wallet and application files from the /root/ folder into your new user directory.

For example, if you installed your ColossusXT wallet as root, and then created a new user namednewuser, you can move your ColossusXT folders using these commands:

sudo mv /root/.ColossusXT /home/newuser/.ColossusXT
sudo mv /root/colx-1.2.3 /home/newuser/colx-1.2.3

Note the sudo command above. If you disable root login, you will need to become familiar with this command, which allows you to run commands as root. For example, when logged in as newuser, you won't be able to reboot the system without using the sudo command sudo reboot.

Install a Firewall: A good option to protect your system from attacks including Denial of Service (DoS) is to install a firewall. The most common one for Linux is Uncomplicated Firewall, or ufw. In fact, depending on which Linux distribution you choose to use, this may already be installed.

To check if ufw is installed, type ufw status at the command prompt. If it says "command not found", it's not installed yet. If ufw isn't installed, use the command apt-get install ufw to install it. And remember, if you disabled root SSH login and are logged in as a different user, you'll need to include the sudo command (sudo apt-get install ufw).

Once ufw is installed, configure it with the following commands:

ufw allow 51572/tcp  (to open the port used by your server wallet)
ufw allow 51573/tcp  (to open the RPC port used by your server wallet)
ufw allow ssh        (to allow ssh and prevent locking yourself out!)
ufw enable           (to enable the firewall)

If you're having network connectivity issues and want to check if the firewall is the problem, you can use the command ufw disable to see if that fixes your problem.

For more firewall information, a good ufw starter guide can be found here.

Now that we're comfortable with the security of our server, we can being setting up the masternode.

Memory / Swapfile Configuration

A ColossusXT masternode requires a minimum of 2GB of RAM to operate. However, most VPS providers offer a base configuration of 1GB or less, and charge an added premium for additional RAM. To avoid this extra cost, you can configure a swapfile to simulate the required 2GB of RAM.

To view your available RAM, use the free command:

Memory is displayed in KB. This system has 1,031,700 KB, or 1GB, of physical RAM installed, and needs additional RAM before it can be used as a masternode.

To configure a swap file, enter the following commands:

fallocate -l 4000M /swapfile
dd if=/dev/zero of=/swapfile bs=1M count=4000
mkswap /swapfile
chmod 600 /swapfile
swapon /swapfile
echo '/swapfile none swap sw 0 0' >> /etc/fstab

NOTE: If you disabled root as described earlier, and are logged in under a different account, you will need to preceed each command with the sudo command.

Now run the free command again. The new 4GB swap file should now be active and displayed in the Swap section at the bottom:

Create The 10M MN Collateral Transaction

To run a ColossusXT MN, the local wallet needs to contain an address with exactly 10M COLX sent in a single transaction. When purchasing COLX for your MN, keep in mind that you’ll likely need to pay some transaction fees to get the coins off an exchange, into your wallet, and sent in a single 10M transaction, so remember to pad your 10M COLX investment with some extra COLX to cover these transaction costs if needed.

First, we need to create a receive address for the 10M transaction. In your local wallet, click on the Receive tab. Enter a new label for this address, such as "Masternode Transaction", then click "Request Payment".

NOTE: This guide was created using a wallet on the ColossusXT Testnet. In the screenshots, instead of "COLX", you will see references to "tCOLX", which is our fake Testnet currency. 

Once the payment address is created, send EXACTLY 10M COLX to this address. Remember, whether you are sending to yourself from within the ColossusXT wallet, or sending from an exchange, the amount received needs to be exactly 10,000,000 COLX. Be sure to account for transaction fees, exchange fees, and withdrawal fees when creating this transaction.

For example, a local transaction sent to yourself will automatically add the transaction fee. Make sure you have enough additional COLX to cover this fee.

A transaction from an exchange will add its own fees also. For example, on Crypto-Bridge, you would actually need to withdraw 10,000,141.1375 to cover their Gateway fee and blockchain withdrawal fee and receive 10,000,000 COLX.

Once you receive your 10M COLX, open the wallet debug console, type masternode outputs, and press [Enter]. This will give you your MN txhash, and your outputidx.

Save both of these pieces of information to a text file; you will need them later.

Create A MN Privkey

In the local wallet debug console, type masternode genkey and press [Enter]. This will general a new privkey (private key) for your masternode.

Save this along with your txhash and outputidx from the previous step.

Edit The Local Wallet masternode.conf

In on your local wallet system, open your masternode.conf file.

In Windows, you can press [Windows]+R, type %appdata%\ColossusXT,  click OK and open the file from there. If prompted for a program to use to edit the file, select Notepad.

In OSX, you can press [Command]+[Shift]+G, enter ~/Library/Application Support/ColossusXT/ (Note: case sensitive!), click Go, and open the file from there.  If prompted for a program to use to edit the file, select TextEdit.

On a new line below the included examples that begin with the # symbol, add a line of text in the following format:

name ip:port privkey txhash outputidx
name: Create a name for your new masternode, such as “COLXMN” or “MN01”.
ip: The external ip address of your server wallet system.
port: Use 51572, the default ColossusXT communicate port.
privkey: Use the privkey generated in the last step.
txhash: Use the txhash generated from the masternode outputs command.
outputidx: Use the outputidx generated from the masternode outputs command (it will be a 1 or a 0).

This will result in a very long string that looks like this:

Save and close the local masternode.conf file, then close and restart your local ColossusXT wallet application.

Edit The Server wallet ColossusXT.conf

Because most server wallets are running on a Linux-based VPS, we will use a Linux text-based text editor to edit the server wallet ColossusXT.conf.

Log in to your VPS. Open the server wallet ColossusXT file in the pico editor by typing pico ~/.ColossusXT/ColossusXT.conf (NOTE: This command is CASE SENSITIVE).

Add the following lines of text to the server wallet ColossusXT file. NOTE: If you are using PuTTY to connect to your VPS, you can right-click to paste, and avoid having to type out the long MN private key.

rpcuser=s9gs49ghs9ghs
rpcpassword=349hdhfghdfhg39
daemon=1
masternode=1
port=51572
externalip=<your masternode IP>
masternodeaddr=<your masternode IP>
masternodeprivkey=<your masternode privkey> 

For rpcuser and rpcpassword, enter your own random characters.

Replace <your masternode ip> with the IP address of your server wallet. Do not include the <> brackets.

Replace <your masternode privkey> with the privkey created in the previous steps.  Do not include the <> brackets.

Once everything is entered and correctly changed to your own MN details, press [CTRL]+X to exit. PressY to save, and [ENTER] to retain the original filename.

Restart The Server Wallet

Navigate to the location of the server wallet executables. If you installed your server wallet to the default location (as instructed in the ColossusXT Linux / VPS Wallet 1.2.3 Setup Guide), use the command cd ~/colx-1.2.3/bin to change to that directory. If you installed to a different location, use that path instead. Verify that you are in the correct folder by typing ls to list the files in that directory. You should see your ColossusXT executables listed:

Now type ./colx-cli stop to stop the server wallet. Once that completes, type ./colxd to start it up again.

Start The Masternode From The Local Wallet

Everything is now in place to start your MN from your local wallet.

Open the local wallet, click the Masternodes tab. Select your MN so that it is highlighted in green. Click Start Alias, then click OK when prompted for confirmation:

Once the MN starts, you will see this success message on your local wallet:

If you receive an error about "unavailable txid", open the local wallet debug console and use the command startmasternode alias true "COLXMN" to start your MN manually. (Substitute your own MN name.)

Once your MN has started, you can use the command ./colx-cli masternode status on your masternode server wallet to confirm the status of your masternode:

It can sometimes take a few hours before a masternode is reported as being online. If you get an error, be patient and keep trying every 15 minutes or so.

Once you get the above confirmation, you're done! Your masternode is now up and running, and you should begin to receive masternode rewards within the next 5-7 hours.

Viewing Masternode Rewards

Once you begin to receive MN Rewards, they will be visible as "Masternode Reward" transactions on the Transactions tab of your local wallet:

Spending Masternode Rewards

New MN holders often worry about accidentally spending COLX from their 10M COLX collateral transaction and inadvertently taking their MN offline. However, this is not possible: Once your txhash is added to your local wallet masternode.conf file, the 10M collateral transaction become unavailable for spending, and cannot be used until the masternode is removed. This will prevent you from accidentally breaking your masternode. You will see a gray lock icon next to this transaction in your payment inputs window:

Additional Resources

If you have any additional questions or run into issues, or would like to suggest changes or additions to this guide, please join us in the #masternode-support channel on our Discord:

http://discord.colossusxt.io

This guide will help you install the ColossusXT wallet version 1.2.4 on Windows and Mac. You can use this for a new install, or to update from your previous version 1.x wallet. If this is a new install, skip over the first two steps and begin with the Download section.

Back Up Your Wallet

The new 1.2.4 wallet version safely updates using your existing wallet files, however, an update is a good time to back up your wallet. If you already have a good backup, you can skip this step.

In the ColossusXT wallet application, click on File, Backup Wallet. Select a safe and secure location for your backup, such as a thumb drive or external hard drive. Consider including the date in the filename (for example, wallet-09-14-2018.dat) for added utility.

Close The ColossusXT Program

If you are running a previous version of the ColossusXT wallet, it needs to be closed before continuing.

IMPORTANT: If you do not complete this step, the wallet will not update correctly!!

For Windows, click File > Exit in the wallet application. On a Mac, click COLX Core > Quit COLX Core. Clicking the "X" in the upper corner does NOT close the wallet application by default; it only minimizes it!

Download The 1.2.4 Application

Visit the ColossusXT GitHub repository to download the latest wallet release:

For 64-bit Windows, download colx-1.2.4-win64-setup-unsigned.exe.

For 32-bit Windows, download colx-1.2.4-win32-setup-unsigned.exe.

For Macs, download colx-1.2.4-osx-unsigned.dmg.

Virus Scanner Note: Some systems falsely identify cryptocurrency-related applications as containing trojans or viruses. If you encounter a virus warning, this is a false positive. Select the option to keep the file and continue. There is no virus or trojan in the ColossusXT wallet application.

Run The Installer Program

Once your download is complete, launch the application installer from the download folder, and follow the Windows or Mac instructions for your operating system:

Windows Instructions: If you receive a message stating "Windows protected your PC", click on the underlined "More info" text, then click "Run anyway".

 On the User Account Control window, click Yes.

Click Next to continue, then click Next to accept the default installation folder. Accept all defaults. Ensure that the box "Run COLX Core 64-bit" checked, and click "Finish".

If the Windows Security Alert screen comes up, check both boxes for Private and Public networks, and click Allow Access. This configures the Windows firewall to allow traffic for the ColossusXT wallet.

The wallet application will now launch and synchronize.

Mac Instructions: Launch the downloaded .dmg application installer.

When the COLX-Core installation windows, click and drag the COLX-qt icon onto the Applications folder icon:

If you receive a message that an older item with the same name already exists, click on "Replace".

Now launch the application from the new shortcut. The first time you run the new ColossusXT wallet application, you may receive the following message:

If this message appears, click OK, and then re-launch the application using Control-click, then click Open from the menu:

Click Open at the security dialog.

This program will now be marked as Trusted. You can launch the wallet application normally from now on. The wallet application will now launch and synchronize.

Verify Version Number

Verify that your ColossusXT Wallet version is now 1.2.4. For Windows, click Help > About ColossusXT Core. On a Mac, go to COLX Core > About COLX Core on the menu bar. Verify that the version number displayed is 1.2.4.

Verify Blockchain Status

Once syncing completes, verify that you're on the current block of the main chain. In the debug console, type getblockcount. This will tell you the newest block in your wallet. Then type getblockhash followed by that block number.

Now visit the COLX Blockchain Explorer and search for that same block number. The blockhash displayed should match the hash from your console:

If it matches, you are good to go.

If it does not match, the best way to resolve this is by following the ColossusXT Bootstrap Guide.

Enable Staking

If this was an update from a previous version and you wish to continue staking, don't forget to unlock the wallet, selecting the option "For anonymization, automint, and staking only." Remember, every time the wallet opens, it is in a locked state and will need to be unlocked before staking becomes active.

If this was a new install of the ColossusXT wallet and you haven't yet configured staking, visit the ColossusXT Staking Guide for more information.

Additional Resources

As always, if you have any questions, please come find us in the #general-support channel of the ColossusXT discord:

http://discord.colossusxt.io

Welcome to the ColossusCoinXT project!

• Need some COLX? Visit out Exchange listings page.

• Need a wallet? Head to the ColossusCoinXT wallet downloads page, download, and install. See the Windows, Mac and Linux install guides for details.

Now let’s put those COLX coins to work and get some staking rewards!

This guide will explain all staking requirements in depth, however, for advanced users or for those already familiar with staking configuration, here are the primary COLX staking requirements:

1. Wallet must be updated to the latest version (see current version here: https://github.com/ColossusCoinXT/ColossusCoinXT/releases/).
2. Your wallet must be online and synchronized.
3. Your wallet must encrypted and unlocked for anonymization, automint, and staking only.
4. You wallet must hold COLX for 8 hours or more.

If you’ve completed those four tasks, you’re ready to stake! Relaunch your wallet and check the lower right corner. The staking status icon is the COLX icon between the lock and the auto-mint icon. Green means you’re currently staking, and gray means you’re not staking yet. (Sometimes it takes a minute or two after launching before the icon turns green.)

If your staking icon is GREEN, you’re good to go! Hover the mouse over the COLX staking icon to confirm that the "Staking is active" banner appears:

Congrats, you’re now staking COLX, and will begin receiving staking rewards based on the amount of coins you have staked.

Ready to receive staking rewards? See the Receiving Staking Rewards section to see what staking rewards will look like and learn about orphan blocks!

Been staking for a while but still haven’t gotten a reward? See Calculating Your Staking Rewards.

Questions about coin splitting? Read the Coin Splitting Guide.

If your staking icon is GRAY, there’s a problem:

COLX staking is simple, but there are a lot of small requirements. Failure to meet one of the requirements is usually the reason you are not receiving staking rewards. Review each section and verify that you’re meeting each requirement. Follow the directions given to fix any issues you encounter, and keep going until your staking icon is green.

Mac users: This guide was written with Windows screenshots, but the Mac wallet is virtually identical. The main difference is that the menu items are on the menu bar at the top of the screen instead of the top of the wallet app, so look there when the File, Settings, or Tools menus are referred to. For any other significant differences, there will be a note labeled “Mac users:”.

This guide contains information and fixes on every common staking issue. However, rather than check them all, let’s start by seeing if we can skip straight to the problem! The COLX console includes a utility to help troubleshoot staking issues. Click Tools, Debug Console. This will open the COLX console. Type the command getstakingstatus. This will give you an output with several true / false values:

A false on any of these properties will keep your staking icon from turning green. The names of these properties are clues about what is wrong.

validtime : false usually indicates a synchronization issue. Skip to the section Wallet must be synchronized.

haveconnections : false is also a synchronization issue. Again, skip to the section Wallet must be synchronized.

walletunlocked : false indicates that your wallet is locked. Skip to the section Wallet must be unlocked for anonymization and staking only.

mintablecoins : false indicates that you have no mature coins. See Wallet must contain mature coins.

enoughcoins : false indicates that your balance is less than the “reserve” balance. (The COLX reserve balance defaults to 0, so this is almost never an issue.)

mnsync : false means that masternode data is not synched. Skip to the section Wallet must be synchronized.

stakingstatus : false means that either one or more of the previous properties was false, or there is another issue. If this is the ONLY false, it usually means one of two things. First, it could be that your wallet is unlocked, but you forgot to check the box that says “for anonymization, automint, and staking only”. See Wallet must be unlocked for anonymization, automint, and staking only. Second, sometimes the wallet simply fails to begin staking. Close and reopen your wallet, unlock it for staking, and allow five minutes for it to begin staking.

After making a correction for one of these issues, close and reopen your wallet, wait for it to synchronize, and re-run the getstakingstatus command to confirm that all previous false flags are now marked true. Make one change at a time. Sometimes it will take a few attempts to get everything set to true.

Normally, fixing the issues flagged as false will quickly get your wallet staking. However, if you are still having issues, or just want to know more about COLX staking, read on for a more complete listing of possible issues and their fixes. There is also a guide for calculating staking rewards, and a guide for coin splitting.

COLX Staking Troubleshooting Table of Contents:

Wallet must be updated to the latest version

Wallet must be encrypted

Wallet must be unlocked for anonymization, automint, and staking only

Wallet must be synchronized

Wallet must contain mature coins

Receiving Staking Rewards

Calculating Your Staking Rewards

Coin Splitting Guide

Appendix A: Firewall configuration

Wallet must be updated to the latest version

To begin staking, your wallet must be updated to the current version. The latest version install is available on the official wallets download page here. There is also an update guide available here.

It is no longer necessary to add staking=1 or seed nodes to your ColossusXT.conf. These settings are now built in to the application.

Wallet must be encrypted

Your COLX wallet must be encrypted to stake. Look for the locked or unlock padlock icon in the lower right corner of the wallet app, like this:

 (green locked icon)

or this:

 (gray unlocked icon)

If the wallet is not encrypted, the padlock icon will be missing entirely, like this:

This means that your wallet is not encrypted. Click on Settings, Encrypt Wallet. You will be prompted to create a password, and will receive a stern warning about password safety. Be sure that your password is safe and secure, and click OK. The app may appear unresponsive for up to a minute as it encrypts your wallet. Be patient. When it is complete, the wallet will notify you that it needs to close. Restart the wallet and verify that you now have the padlock icon in the lower right.

Wallet must be unlocked for anonymization, automint, and staking only

A locked wallet cannot stake COLX. This is indicated by the padlock icon in the lower right corner of the wallet app. (If the padlock icon is missing, the wallet is not encrypted. See previous section.) An open gray padlock is an unlocked wallet; a closed green padlock is a locked one.

Hover over the lock icon for additional details. A correctly configured staking wallet will say “Wallet is encrypted and currently unlocked for anonymization and staking only”:

If this is not the case, click on Settings, Unlock Wallet. Enter your password and click the checkbox marked “For anonymization and staking only”, and click OK.

Recheck the padlock icon to verify that it’s now gray and unlocked, and hover over the padlock icon to verify that it’s unlocked for staking and anonymization.

Important Note: The wallet app ALWAYS locks your COLX wallet by default every time the wallet is opened. This unlocking step will always need to be repeated, EVERY time your wallet or PC are restarted!

Wallet must be synchronized

Check the lower right corner of your COLX wallet. If it’s correctly synchronized, there will be a green check mark. Hover the mouse over the green check mark to verify that it says “Synchronization Finished. Up to date.” and displays the current block number, like this:

If your wallet is not synchronized, it might look like this:

The network connectivity icon or “No block source available” error indicates that there is no connectivity to the COLX network. Be patient! Usually this will resolve itself on its own by generating its own node list using the hardcoded seed nodes. Within 3-5 minutes, it should look like this:

Hovering over the yellow circle arrows icon will give you the synchronization status and the current block number. Synchronization can take anywhere from a few minutes to several hours, depending on your internet connection. Once the yellow circle arrows turn to a green check mark, synchronization is complete.

Seed nodes are built in to the wallet application; it is no longer necessary to add nodes to the ColossusXT.conf configuration file. However, wallets updated from previous installs may still contain legacy nodes that were previously added. If syncing isn't beginning within a few minutes, try closing your wallet, deleting any addnode= entries from your ColossusXT.conf, deleting your peers.dat, and then restarting your wallet.

To locate the ColossusXT.conf file in Windows, press Windows+R, then type %appdata%\ColossusXT and click OK.

To locate the ColossusXT.conf file on a Mac, press Command+Shift+G, then type ~/Library/Application Support/ColossusXT and click Go.

If synchronization does not start after 5 more minutes, you may have a network connectivity issue. See Appendix A: Firewall Configuration.

Wallet must contain mature coins

COLX staking requires that coins be held for 8 hours before staking can begin. To check if your coins are mature enough, click on Send, and then Open Coint Control. If the Coin Control, button isn’t available, then you need to enable. To do that, click on Settings, Options, Wallet, and check the box for “Enable coin control features”, then restart your wallet. Mac users: On a Mac, access the coin control option from the menu bar at the top of the screen, under PI