Claim a miner

This guide describes how you start using CIDgravity with a first miner.

Get ready onboarding deals with CIDgravity in less than 5 min. All you need is a valid github account and being able to prove the miner ownership by signing a challenge (remote access to the miner)

Connect to the CIDgravity app and follow the onboarding instructions. This will guide you through the the few steps to setup the initial configuration.

Compatibility matrix


Fill the miner ID

Enter the minerID you wish to use to start the claiming process.

Enter the minerID you want to claim

In the next step, you will need to sign a challenge message with the worker key to confirm miner ownership.

The command is generated with all required information as follows:


Define a friendly name

The friendly name is utilized throughout the entire app for easy identification of a miner. It can be modified later through the settings.

Choose a friendly name for this miner

Import settings from another miner (optional)

If you already manage another miner with CIDgravity, you can directly import its settings.

Initial settings (optional)

  • Number of storage deals per hour: The maximum number of storage deals accepted over the last 60 minutes, across all clients.
  • Cumulative storage deal size per hour: The maximum cumulative storage deal size (GiB) accepted over the last 60 minutes.
  • Retrieval deals per hour: The maximum number of graphsync retrieval deals accepted over the last 60 minutes, across all clients.
  • Custom message: A personalized message that will be appended to rejection message sent to clients (e.g. “you can contact us at me@mydomain.wyz”)
  • Accept storage deals from unknown clients: Enable or disable the storage deals from clients not previously created. If disabled, such deals will be rejected, ensuring that only recognized clients data are stored.
Define the global limits for this miner

Connector token

The last screen presents the token needed to configure the CIDgravity connector on the miner. This token is also accessible from the Settings page.