• Download
• Get Started
• Resources
• Community
• What is this?
• Network Status

KatKoyn Wallet Software

To use KatKoyn, download and run the KatKoyn software.
When run for the first time, the entire blockchain will be downloaded. This can take several hours, but only has to be done once.

If restarting the software after a few hours or days, it will automatically 'catch up' when started, this may take a few minutes.

KatKoyn v2.4 - March 2023

This is the first release with new KatKoyn branding. All functionality is identical to the previous Nyancoin release.
All previous Nyancoin keys, wallets, blockchain data and everything else is the same.

Filename Changes

Due to filename changes, this is NOT a direct drop-in replacement for v2.3
The previous wallet file, configuration file and blockchain files can be used.
However some changes will be required:

• Executables have been renamed, nyancoind -> katkoynd, nyancoin-qt.exe -> katkoyn-qt.exe and other equivalents.
• The config file has changed from nyancoin.conf to katkoyn.conf
• The default data directory is now .katkoyn on linux based systems, or similar to ...AppData\Roaming\KatKoyn on Windows and others.

Suggested upgrade process

• Download the new version, or compile from source if required.
• Stop the old version and wait for it to exit completely.
• Make at least one backup of wallet.dat, preferably multiple copies to an external storage device (You should be doing this regularly anyway)
• Remove the old executable, and replace with the new. Old ones are named nyancoin*, new are katkoyn*
• Rename the configuration file from nyancoin.conf to katkoyn.conf
• Rename the folder / directory that contains the data files. Anything previously named 'nyancoin' is now 'katkoyn'
• Alternatively if using command line options to set a custom data directory, this can be kept as-is, or you can rename the location and amend the command line to match.
• Start the executable. If you have previously used command line options, these will still be valid.

If these filename and location changes are not made, the software will run as for a new installation, and all previously used files will be ignored including the wallet. If this happens, you have NOT lost anything - it's just that the wallet and other files are not recognised. Stopping, renaming and starting again will fix that problem.

New installations

• Download the new version, or compile from source if required.
• For GUI desktop versions, copy the executable to a suitable location.
• For katkoynd command line versions, it is recommended to run the executable under it's own user, with the files in a directory for that user.
• Start the executable, the default data location will be used.
• Alternatively a custom location can be set using command line options.
• Wait while the blockchain is downloaded - this will take several hours or more depending on system capabilities.
• When complete, make at least one backup of wallet.dat, and continue to make backups regularly.

WARNING: If wallet.dat is deleted or corrupted, all of your KatKoyn will be lost forever. Backups are essential.

Installation Notes

Approximately 4GB of disk space is required for the blockchain files. This will increase over time.
Using spinning rust disks as storage may impact startup time, however should not affect operation once the blockchain is fully synced.
If using a Raspberry Pi or similar, an external storage device is recommended. Storing blockchain files on an SD card will result in very poor performance and is likely to cause premature failure of the card.

For virtual servers, cloud environments and devices such as the Raspberry Pi, a minimum of 2GB RAM is suggested. It may be possible to run it with less, but performance is likely to be poor.

The software uses port 33701 for incoming peer to peer connections.
For the best performance, this port should be opened in your firewall.
For desktop versions this can be done via uPNP: Settings - Options - Network and select the 'map port using uPNP' option.
For command line, you will need to configure any software firewall, upstream firewall or gateway manually to allow incoming connections on 33701.
The software will still function with port 33701 blocked, however you will only have outgoing connections which will probably result in a very small number of connected peers.

Windows

Version 2.4, 11 March 2023:

Windows 32 bit, zip file 51MB

Windows 64 bit, zip file 49MB

Mac

Version 2.3, 28 December 2022:

Due to a currently unresolved problem with the build process, a 2.4 version is not available for Mac.

nyancoin2.3-x86_64-macos.tar.gz Version 2.3 is still valid, 13MB.

Linux, Source and all other packages

v2.4, 11 March 2023: https://github.com/KatKoyn/katkoyn-client/releases/tag/v2.4.0

Older versions

Nyancoin v2.3 is still valid, and has the same functionality as KatKoyn v2.4.

Versions v2.2 and earlier are no longer supported on the main network due to the introduction of AuxPow at block height 4574574 on 11 January 2023. If you are still using v2.1 or earlier, please upgrade to the latest version.

v2.x uses the same blockchain files, upgrade as described above.

v1.x will require that the blockchain files are reindexed (this will happen automatically but may take a few hours). Alternatively install v2.4 as new, and then restore the wallet.dat file from a backup.

The wallet.dat file is the only file which is essential - make backups of it regularly. Everything else can be reinstalled or downloaded from the network.