How to Use

Obtaining The Latest TurtleCoin® Software

  1. Proceed on over to TurtleCoin® Releases to grab the latest copy for your system.

Obtaining TurtleCoin® Checkpoints - Browser

  1. Right click one of the links on the Checkpoints page, and select Save link as...
  2. Save the file with a name that is easy to remember. (ie. checkpoints.csv)

Obtaining TurtleCoin® Checkpoints - CLI Mode

  1. Copy one of the links on the Checkpoints page
  2. Download the checkpoints via curl:
      curl <link> -o checkpoints.csv

      curl -o checkpoints.csv

Using the Checkpoints - Windows

  1. Copy the checkpoints you downloaded into the same folder as your copy of TurtleCoind.exe
  2. Open a command prompt window in the folder where you just placed the checkpoints file.

      ProTip: Type cmd in Windows Explorer when in the folder to start command prompt from that folder.

  3. In the command prompt window, type the following to start the daemon with the checkpoints:

      TurtleCoind.exe --load-checkpoints checkpoints.csv

Using the Checkpoints - Linux / Apple

  1. Copy the checkpoints you downloaded into the same folder as your copy of TurtleCoind
  2. Open a terminal window in the folder where you just placed the checkpoints file.

      ProTip: Your file manager may provide the ability to open a terminal in your current directory. Right-click in the folder to see if the option is available.

  3. In the terminal window, type the following to start the daemon with the checkpoints:

      ./TurtleCoind --load-checkpoints checkpoints.csv

Expected Output

If everything went well, you will see output such as what is shown below.

TurtleCoin v0.19.0.1293 ()
This software is distributed under the General Public License v3.0

Copyright 2018-2019, The TurtleCoin Developers

Additional Copyright(s) may apply, please see the included LICENSE file for more information.
If you did not receive a copy of the LICENSE, please visit:
https://github.com/turtlecoin/turtlecoin/blob/master/LICENSE


2019-Oct-13 14:44:31.470231 INFO Program Working Directory: "/home/turtlecoin/turtlecoin"
2019-Oct-13 14:44:31.474230 INFO Loading Checkpoints for faster initial sync...
2019-Oct-13 14:44:33.122273 INFO Loaded 1910844 checkpoints from checkpoints.csv

  Oh No! Something Went Wrong

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

Solution: This error occurs if you attempt to use a file that is corrupted or not a CSV file. Please re-download the file, verify the filename, and try again.

Failed to Load Checkpoints

2018-May-13 12:10:08.325056 INFO Loading Checkpoints for faster initial sync...
2018-May-13 12:10:08.339667 ERROR Could not load checkpoints file: checkpoints.csv
2018-May-13 12:10:08.341758 ERROR Exception: Failed to load checkpoints

Solution: This error occurs if the file is not present in the directory you are in. Please make sure that the checkpoints.csv file is in the same directory as the one you are working in.

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

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

Solution: You are not currently in the directory in which TurtleCoind resides. Please verify you are in the correct place and then try again.

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

Solution: Close any other running copies of TurtleCoind and try again.