Skip to main content

Delegating with Ledger Devices

Ledger Initialization

Before getting started, you need to complete two prerequisite steps:

  1. Setup your Ledger device from their official documentation.
  2. Connect your Ledger to your cspr.live account by following the Ledger Setup guide.

Important Notes

  1. CRITICAL: Write down and hide your recovery codes! Without these, you will never be able to restore your account in the event that you lose or damage the hardware key.
  2. Currently, Casper accounts do not link to the Ledger Live application, so your account balances will not show on Ledger Live. However, you can still safely use the Casper application on the hardware key to transact with and store tokens.
  3. When logging in to cspr.live, the UI will offer numerous public keys. Choose any of them. They are all derived from the Master Seed that is secured in the Ledger key (more info here). Make sure you write down whichever public key(s) that you end up using so that you have no confusion when trying to login in the future.

Staking with a Validator

Connect and Login with Ledger

  1. Connect your Ledger to your computer via USB and enter your PIN to unlock it.

  2. Open the Casper app on the Ledger (you will see the message “Casper Ready”).

    Casper Ready
  3. Sign in to cspr.live with your Ledger by clicking “Connect” under the Ledger option as shown in the screenshot below.

    Casper Ready
  4. Select the public key connected to your Ledger account.

    Casper Ready
  5. View your account by clicking on your public key at the top right corner.

    Casper Ready

Receive Tokens from External Wallet

This portion will vary slightly depending on where your funds are currently stored. However, the process will require that you send tokens to your public key as described in the documentation.

Staking Tokens

Once you have tokens in your account, staking (delegating) with a validator is easy!

  1. Go back to your account but this time open the "delegate" tab located at: https://cspr.live/delegate-stake (alternatively, you click on Wallet ⇒ Delegate Stake to go there).

  2. From the validator list, choose any validator you like. You will notice they all charge different fees and have different amounts staked to them. This may inform your decision in choosing the validator that is right for you.

  3. Specify the amount you wish to stake or click “Delegate max” as shown below. Notes:

    1. Keep in mind that the total delegation amount to one validator cannot be less than 500 CSPR.
    2. Both delegation and undelegation have an associated fee, so you may wish to leave some funds in your account to cover transaction fees. Otherwise, you may need to deposit additional funds to undelegate later.
  4. Click “Next” to continue as shown below.

    Casper Ready
  5. The page will update with a confirmation page asking you to verify all the details. If everything looks correct, click the “Confirm and delegate stake” button.

  6. You will be presented with a final page asking you to sign the transaction with Ledger. Click the “Sign with Ledger” button at the bottom.

    Note: If you get an error showing a “Transaction rejected” message, then make sure your Ledger device is active and connected to your computer. You may also need to re-enter your PIN if it locked itself due to inactivity.

    Casper Ready
  7. On the Ledger, you will see a message saying “Please review”. Click through the fields and verify everything matches what is being shown to you on cspr.live.

    Casper Ready
  8. Once you click “Approve” you will see the Delegation Completed screen verifying that your staking successfully was submitted to the blockchain.

    Casper Ready Casper Ready
  9. At this point, you can return to your account and wait until the completion of the era when the block gets included into the chain. Once the era completes, you will see that your liquid balance has decreased by your staked amount and reflected in the “Staked As Delegator” row in your account.

    Note: If you staked your full balance, don’t panic if you see a 0 CSPR balance whenever you log in! This is just because it is showing your liquid assets, not your total balance. If you want to see your full balance and asset breakdown between liquid, staked, and undelegated tokens, you can go to your account details page as shown below.

    Casper Ready

Unstaking with a Validator

Initiate the Undelegation

Now that you have funds delegated, you may wish to liquidate them by unstaking. As demonstrated below, on your account’s profile page, click “Undelegate” to get started.

Casper Ready

The next page “Undelegation details” will ask you how much you wish to undelegate. If you select “Undelegate max”, it will attempt to liquidate all of your staked assets (minus the transaction fee). Once you enter a valid amount, the “Next” button will become clickable. Below you can see that I entered 313.02931 CSPR to be able to proceed.

Casper Ready

You will next be shown a confirmation screen. If everything looks good, then click “Confirm and undelegate stake” to proceed.

Sign the Undelegation

You will have to sign the transaction to verify your account is initiating this action.

  1. Connect your Ledger device to your computer if it is not already.

  2. Unlock your Ledger by entering your PIN.

  3. Open the “Casper” app and make sure that you see “Casper Ready”.

  4. Then back on cspr.live click the “Sign with Ledger” button shown below.

    Casper Ready

On your Ledger, you will see the transaction details. Verify all the information with what is being presented to you on the screen. If it looks good, then approve the transaction. If all goes according to plan, you will be presented with an “Undelegation completed!” screen.

Casper Ready

Note: There is a 7 era delay to undelegate. Era duration is approximately 120 minutes. While the funds go through undelegation, the balance will appear in the “Undelegation” row in your account profile page as you can see below.

Casper Ready

After the undelegation period completes, your funds will be liquid and available for you to re-stake, withdraw, or use however you wish.

Enjoy the fruits of your staking labor!