Curio CLI

Curio command-line interface

Curio ships with 2 binaries called curio and sptool by default.

Curio Binary

The command line interface (CLI) for Curio operates slightly differently from typical software. Some commands, such as those related to storage, make API calls in the backend, while others interact directly with the database to perform the required actions.

Commands that make API calls require authentication since the Curio API is permissioned. This authentication involves passing a token and address with the API call. The Curio CLI handles this authentication seamlessly, eliminating the need to set environment variables for the token and address. It retrieves the authentication and actor details from the database and generates the API call accordingly.

This design allows you to make changes to a remote node without having direct access to it. For example, you can detach storage in Node 2 from Node 1. All such commands are nested under the cli subcommand.

To perform actions on a remote machine, you must provide the correct IP address and port using the --machine flag in the format --machine=10.0.0.1:12300.

This documentation explains the unique aspects of the Curio CLI, including its authentication process and how to interact with remote nodes.

The curio CLI references can be found here.

Sptool Binary

Certain administrative and monitoring operations require updating or fetching information about the minerID from the chain. These operations do not need access to the database and therefore are not included in the Curio binary. Instead, these commands are hosted under the sptool binary. The sptool binary provides an interface with the Filecoin blockchain for operations required by a storage provider.

The sptool CLI references can be found here.