Announcing the reference release of Peercoin-Qt.app (v0.4.0), for OS X.
PPCoin-Qt-v0_4_0.dmg
MD5: 38451f4f73c38e1292d102dedad7c0d0
ppcoind-0.4.0-macosx.zip
SHA-256 (ppcoind): 5bd91f8c5f0a8bd3fa65cf22f298fad327f930e62771a77cd7a491789e84f312
Release Notes
[ul][li]The current :master branch of the ppcoin/ppcoin source code requires a few files to be updated for the application to be built correctly. Those updates were included in a pull request that Bitpar submitted, which, as of 05-05-2014, has not been merged with the main repo. I personally compiled this distribution using those changes.[/li]
[li]The distribution is still called “PPCoin-Qt.app”, as that is what the official release uses.[/li]
[li]The distribution has been tested on OS X 10.8.5 (Mountain Lion) and 10.9 (Mavericks). It has been built to support any version of 64-bit version of OS X, which includes 10.6 through 10.9. 32-bit support has been discontinued.[/li][/ul]
OPTION 1 (updated 06-MAY-2014):
If the last time you ran your PPCoin-Qt.app client or ppcoind daemon on your Mac was BEFORE 05-MAY-2014, you should not have to re-download the block chain or follow the instructions below. To update from v0.3 to v0.4.0, do the following:
[ol][li]For one last time, launch PPCoin-Qt.app (v0.3). Once it is running, from the file menu, select “File” > “Backup Wallet”, and pick a location to store the backup.[/li]
[li]After the backup has been made, close the application. You are now ready to replace it with the new version.[/li]
[li]In your Applications folder, locate PPCoin-Qt.app (v0.3). Drag the application outside of the Applications folder (or, use right-click, “Move to Trash”)[/li]
[li]Open the v0.4 .dmg that you downloaded from the link above.[/li]
[li]In the folder that opens up when you launch the .dmg, drag the application, PPCoin-Qt.app into the “Applications” shortcut. This will copy the application to your hard drive.[/li]
[li]Launch PPCoin-Qt.app from your Applications folder (any dock icons you have are going to point at the old v0.3 version, so they will need to be removed and replaced). The network will synchronize with any changes to the block chain since you last had the application open. After that, you will be set up on v0.4.0, and won’t need to do anything else.[/li][/ol]
OPTION 2:
If the last time you ran your PPCoin-Qt.app client or ppcoind daemon on your Mac was AFTER 05-MAY-2014, you will have to re-download the block chain or follow the instructions below.
Because this release came after the protocol switch from v0.3.1 to v0.4.0, if you previously ran PPCoin-Qt.app on your Mac, you will need to re-download and synchronize with the Peercoin block chain. I’d like to make this as easy as possible for people, but at the same time, do everything I can to ensure that you don’t run into any problems. The most straight-forward way to do this is using the command line, which may make you nervous, but I will walk you through every step. I’ll consider if it makes sense to pull together script that can run these steps automatically, but until then, here are the instructions.
First, a disclaimer…
THE WALLET.DAT FILE CONTAINS THE PRIVATE KEYS THAT LINK PEERCOINS IN THE BLOCK CHAIN TO YOUR PERSONAL WALLET – FAILURE TO PRESERVE THEM WILL RESULT IN A LOSS OF THE ABILITY TO CLAIM OWNERSHIP.
Take care while conducting the next steps, and if you have any questions at all, please don’t hesitate to ask – I’d rather have 100’s of questions posted, than to have one of you run into any problems with these instructions.
Note: It’s easiest if you copy/paste the lines, rather than typing them, because there may be spaces or characters present that you do not notice.
-
If the previous version of PPCoin-Qt.app is running, shut it down (which it shouldn’t be, but just in case…)
-
Launch Terminal.app (Applications > Utilities > Terminal)
-
From the command line, you’ll need to first navigate to the hidden folder that contains all of the relevant Peercoin files (block chain database, block index, wallet.dat, etc.) Enter this command to change your directory to “PPCoin”:
cd ~/Library/Application\ Support/PPCoin/Press ENTER. You can confirm that you are in the right place by looking at the command line prompt. If you are, you’ll see something like:
mac:PPCoin your-username$Alternatively, you can list the directory contents with the ls command. If you haven’t made previous modifications to the folder, you should see this displayed after you run the command (depending on how long you have had your Peercoin wallet, you may see multiple versions of the block data files (blk0001.dat, blk0002.dat, etc.):
ls
addr.dat blkindex.dat db.log wallet.dat
blk0001.dat database debug.logNote; If you have a file called [font=courier]ppcoin.conf[/font], include it in the next step when you duplicate the files.
- Just to be safe, you’ll next want to back up your [font=courier]wallet.dat[/font] and [font=courier]addr.dat[/font] files. The steps you will do after this won’t touch those files, but it’s a good idea to keep them backed up before you make any modifications to the directory, just to be extra cautious. We’ll first create a new folder on your desktop and then move a copy of the two files into it.
mkdir ~/Desktop/DuplicatedPPCFiles
cp wallet.dat ~/Desktop/DuplicatedPPCFiles/wallet.dat
cp addr.dat ~/Desktop/DuplicatedPPCFiles/addr.dat-
Check on your desktop to make sure that the “DuplicatedPPCFiles” directory has been created and that the duplicates of wallet.dat and addr.dat are in there. Once you’ve confirmed that they are, move on to the next step.
-
It’s now time to remove the block chain database and index. Run this command to remove all of the files that start with “blk” (the ones we want to remove):
rm blk*- And that’s it. You can now open up the .dmg that is linked above, and copy PPCoin-Qt into the Applications folder alias in the disk image. This will overwrite your v0.3 version of PPCoin-Qt.app with the new v0.4 version. Once that’s finished, launch PPCoin-Qt.app and your client will synchronize with the block chain, and begin to re-download it. Don’t be concerned if the wallet balance shows “0.00 PPC” for a while – you’re going to need to catch up with the block chain before your transactions start to appear, as their containing blocks are processed.
The last four times that I tried this, to confirm that the process was working correctly, it took about 35 minutes to fully download and synchronize the Peercoin block chain, though your times may vary depending on your network speed and processor.
- You can confirm that you are running the correct version of the software by selecting Help > Debug window from the menu bar. For the client version, you should see “v0.4.0ppc-3-gc4b38a3-beta” listed.
Once that’s done, you’re back to where you were before the protocol switch. No changes will have been made to your wallet files, so your existing pass phrase is still the same if you’ve encrypted your wallet. You can either retain the backups of the wallet.dat and addr.dat files you made, or delete them, though I’d recommend maintaining them until you’re sure that you didn’t experience anything out of the ordinary.
Thank you all for your patience, and hopefully that’s the last time that we run into a situation where the OS X build isn’t ready at the same time that the Linux and Windows versions are.
Please don’t hesitate to let me know if you have any questions or concerns, or if you experience any problems using the distribution.