Chinilla Keys Management

Chinilla keys management

The purpose of this page is to provide guidance on how to setup Chinilla keys for plotting, farming, receiving rewards and managing your wallet. It does not explain the Chinilla Keys Architecture. You can find this explanation here: Chinilla Keys Architecture. It is mostly CLI focused; sorry GUI users.

1 key (default)

This solution is the most straightforward, you use only one key for everything: plotting, farming, receiving rewards, managing your wallet. It is the default configuration when you install Chinilla for the first time. The CLI (or GUI) creates a new private master key on the first initialization. Show can see it's mnemonic by typing: chinilla keys show

By default, the rewards from farming will be sent to this private key's wallet address.

With this setup you can farm, plot and manage your HCX all at once. The risk is that, if your computer is compromised, the attacker would have access to your wallet and could potentially steal the HCX.

Another solution for farming HCX and securing them is to use two keys:

2 keys (farming key + cold storage key)

1. Default key used for: plotting and farming
2. Cold storage key used for: Wallet operations. Receiving/Sending funds and receiving farming rewards.

The downside of that solution is that you will not have direct access to your wallet and HCX. Would you want to do an HCX operation you will have to manually import the cold storage key. The upside is: even if your computer is compromised the attacker will not be able to access your wallet. Since the private key receiving rewards will not be stored on it.

Configuration steps:

• Create a second key for "wallet" operation purposes: chinilla keys generate
• Write down the mnemonic on a paper you will not lose. If you lose it your key and HCX will be lost for ever !
• Remember the fingerprint for the next step
• Find the "First wallet address": chinilla keys show and copy it
• Open ~/.chinilla/vanillanet/config/config.yaml
• Edit: hcx_target_address: XXX replace it with the newly generated "First wallet address".
  • There should be two occurrence of hcx_target_address. One under the farmer section and the other one under the pool section.
• Save the file and close it.
• Delete the second key: chinilla keys delete -f <fingerprint>
  • /!\ Caution: make sure you have a backup of the 24 words mnemonic or you will lose access to the key for ever.
• It should prompt a WARNING message like

Deleting private_key with fingerprint WARNING: using a farmer address which we don't have the private keys for. We searched the first 500 addresses. Consider overriding with

• Make sure the <cold-storage-wallet-address> corresponds to your second key wallet address.

Your setup is complete. Your machine can farm HCX and rewards will be sent to the key that you stored on paper. Would you need to transfer funds you can add it back to your computer's chinilla keychain by doing: chinilla keys add

TODO

• How to setup different keys for plotting / farming / wallet (3 keys).
  • How to create plots for another farming private key.