Using checkpoints

Sajo8 edited this page Jul 15, 2018 · 5 revisions

Using Checkpoints to Sync Blockchain Faster

Instead of verifying every block's cyptographic signature, use a pre-computed list to simply check the signature matches the height.

Setup

  • Right click this link and choose Save link as... to download checkpoints.csv.

  • Place checkpoints.csv in the same folder as your daemon(TurtleCoind) and wallet(ZedWallet).

  • You can get them both from here if you don't have them already.

  • Make sure you shut down any GUI wallets, or any other instances of TurtleCoind.

Usage

Windows

  • First, open a command prompt in the same directory as TurtleCoind.
  • This can easily be done by moving to the TurtleCoind directory in Windows Explorer, then typing cmd in the search bar and hitting enter:

Opening cmd

  • Finally, type TurtleCoind.exe --load-checkpoints checkpoints.csv in the command prompt.

Linux, Mac

  • First, open a command prompt in the same directory as TurtleCoind.
  • You can use the cd command to change to this directory. For example, cd Downloads/turtlecoin-v0.5.0
  • Alternatively, your file manager may provide the ability to open a terminal in your current directory. Navigate to the folder with TurtleCoind in, and try right clicking, to see if you can open a terminal there:

Opening terminal

  • Finally, type ./TurtleCoind --load-checkpoints checkpoints.csv in the terminal.

Expected Output

If you did the steps correctly, you should see something like this output.

2018-May-13 11:58:39.654478 INFO    Welcome to TurtleCoin v0.5.0.1260 ()
2018-May-13 11:58:39.654914 INFO    Module folder: TurtleCoind
2018-May-13 11:58:39.655249 INFO    Loading Checkpoints for faster initial sync...
2018-May-13 11:58:40.854979 INFO    Loaded 435695 checkpoints from checkpoints.csv
  • TurtleCoind will then start syncing from checkpoints.
  • If you are using the CLI wallet, then you can just wait for it to finish syncing, and open your wallet(leave the daemon open!).
  • If you are using a GUI wallet, let it finish syncing, close it down by typing exit in the window, then open your GUI wallet.

Common Errors

Invalid checkpoint file format

2018-May-13 12:10:08.325056 INFO    Loading Checkpoints for faster initial sync...
2018-May-13 12:10:08.339667 ERROR   Invalid checkpoint file format
2018-May-13 12:10:08.341758 ERROR   Exception: Failed to load checkpoints
  • If you see output like the above, the file you are opening is either not a .csv file, or hasn't been downloaded correctly.
  • Ensure you downloaded the file by right clicking, and choosing Save link as....
  • If you incorrectly chose the wrong file, you can accidentally download a html page instead.
  • When you open up the file, it should have lots of lines like this:
0,7fb97df81221dd1366051b2d0bc7f49c66c22ac4431d879c895b06d66ef66f4c
1,8c9738f961a278486f27ce214d1e4d67e08f7400c8b38fe00cdd571a8d302c7d
2,2ef060801dd27327533580cfa538849f9e1968d13418f2dd2535774a8c494bf4

Failed to load checkpoints

2018-May-13 12:14:57.544286 INFO    Loading Checkpoints for faster initial sync...
2018-May-13 12:14:57.544569 ERROR   Could not load checkpoints file: checkpoints.csv
2018-May-13 12:14:57.544823 ERROR   Exception: Failed to load checkpoints
  • If you see output like the above, it means the file isn't present in the directory you are in.
  • Make sure you have placed the checkpoints.csv file in the same directory as TurtleCoind.

TurtleCoind.exe is not recognized / No such file or directory

C:\Users\gentoo>TurtleCoind.exe --load-checkpoints checkpoints.csv
'TurtleCoind.exe' is not recognized as an internal or external command,
operable program or batch file.

bash: ./TurtleCoind: No such file or directory

  • If you see output like one of the above, it means your terminal isn't in the same folder as the TurtleCoind program.
  • You can type pwd (or dir on Windows) to see what folder you are currently in.
  • Try following the steps above to get into the right folder, then try again.
  • If you type ls(or dir on Windows), you should see the TurtleCoind program, if you are in the correct folder:
[turtlecoin-v0.5.0]λ ls
miner  poolwallet  zedwallet  TurtleCoind  walletd

IO error

2018-May-13 11:58:40.857058 INFO    Opening DB in /home/zach/.TurtleCoin/DB
2018-May-13 11:58:40.858174 ERROR   DB Error. DB can't be opened in /home/zach/.TurtleCoin/DB. Error: IO error: While lock file: /home/zach/.TurtleCoin/DB/LOCK: Resource temporarily unavailable
2018-May-13 11:58:40.873692 ERROR   Exception: IO error
  • If you see output like the above, something else has got the database open already.
  • Make sure you have closed down any other TurtleCoind's, GUI wallets, and walletd.
  • Use a task manager to help you find any which might be running in the background, then try again.
Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.