Desktop Wallet

Fast Syncing Method for Desktop Wallet

Raiblocks desktop wallet screenshotOne of the biggest barriers to using a desktop wallet versus a web wallet, for new Nano users, is the initial sync of the blockchain required to send, receive and view balances. As of December 2017, the blockchain stood at around 1.4 GB in size, a number which is rapidly growing as Nano gains adoption.

While the new, Nano desktop wallet is undergoing development, the official Nano Classic wallet (formerly the RaiBlocks wallet) remains fully compatible with the Nano blockchain. Download it for Windows, Mac or Linux here: https://nano.org/

For users with slow Internet connectivity, or hard disk drives instead of SSDs, syncing the blockchain from other peers may span over many days or never seem to complete. Normally, the chain should sync within several hours or overnight. So, if you have waited that long and it still isn’t done (says Synchronizing in the wallet, instead of Running), then you may want to download and extract the blockchain manually.

You can check the most recent block number that the Nano network is on at nano.org. Assuming the block number showing up in your desktop client is significantly behind the current block number, then your initial sync has not completed yet, and you won’t be able to transact in Nano until it does.

Step 1: Backup your seed and ensure you’re on version 9.0 or above.

Especially if you’ve already sent funds to your Nano address, do not attempt to make any changes to your desktop wallet or import the blockchain manually, unless you have backed up the seed. The seed is used by the Nano wallet to deterministically generate private keys corresponding to all of the accounts (i.e. Nano addresses) in your wallet.

Again, if you lose this seed, you lose both the unpocketed and pocketed funds that have arrived at your address(es) so BACK IT UP. Write it down on a piece of paper, check your handwriting multiple times, and put it in a fire-proof safe, or bank safety deposit box.

Step 2: Download the Nano blockchain archive for your platform.

You should bootstrap it using the daily snapshots from Google Drive or Yandex.Disk.

There is a Windows (contains Win64 in the file name) and Linux version (doesn’t contain Win64). Mac users should also download the Linux version. To avoid data corruption or tampering of the files, verify the checksum using a command line utility or graphical tool before attempting to import it into your Nano wallet in the next step.

Step 3: Extract the archive and copy the data.ldb file to your Nano wallet “app data” directory.

Quit the Nano wallet app, and copy the extracted data.ldb file to the following directory corresponding to your OS. Overwrite the existing data.ldb file if prompted.

Windows – C:\Users\username\AppData\Local\RaiBlocks

Mac OS X – /Users/username/Library/RaiBlocks

Linux – ~/RaiBlocks

Step 4: Reopen the Nano desktop wallet.

Once you relaunch the Nano wallet GUI, it will continue syncing from the point in the blockchain when the data.ldb file was dumped. Because you have the latest blocks up until the datestamp of the data.ldb file you downloaded, you’ll only need to download any transactions that happened on the network since then, to be fully synced. This should be significantly faster, compared to downloading the entire blockchain from other peers.