CLI Terminal Commands

This page should provide additional high-level documentation and explanation beyond just rolls -h.

Usually, the -h (help) text is clear enough. If you do need more context, use the -h switch in the terminal.

Example of Rolls-blockchain terminal commands:

• rolls -h
• rolls plots -h
• rolls plots check -h
• rolls start -h

As with the rest of this project, this doc is a work-in-progress. Feel free to browse the source code to find out more.

Locate the rolls binary executable

Mac

If you installed PecanRolls.app in your /Applications directory, you can find the rolls binary at /Applications/PecanRolls.app/Contents/Resources/app.asar.unpacked/daemon/rolls.

Do a sanity check in Terminal.app with

/Applications/Chia.app/Contents/Resources/app.asar.unpacked/daemon/rolls -h

You can use that if you augment your PATH with

PATH=/Applications/PecanRolls.app/Contents/Resources/app.asar.unpacked/daemon:$PATH

and then rolls -h should work.

Windows

There is more than one PecanRolls.exe binary; the GUI is PecanRolls.exe (two of these!) and the CLI is rolls.exe. They are found in different places. Note the big C versus the little c.

~\AppData\Local\rolls-blockchain\app-1.1.3\resources\app.asar.unpacked\daemon\rolls.exe

init Command: rolls init

First, init checks for old versions of rolls installed in your ~/.rolls directory.

If so, init migrates these old files to the new version:

config (including old SSL files) db wallet Using config.yaml, updates wallet keys and ensures coinbase rewards go to the right wallet puzzlehash. If no old version exists, init:

Creates a default rolls configuration Initializes a new SSL key and cert (for secure communication with the GUI) start Command: rolls start {service}

Service node will start only the full node. Service farmer will start the farmer, harvester, a full node, and the wallet. positional arguments: {all,node,harvester,farmer,farmer-no-wallet,farmer-only,timelord,timelord-only,timelord-launcher-only,wallet,wallet-only,introducer,simulator} Flags