Celo Wallet Guide: A CeloCLI + Ledger cheat sheet for cGLD holders

Francesco Cremona
May 6 · 4 min read

Latest update: May 2020

Image for post
Image for post

This guide will go through the basic commands that cGLD holders will need to run on the Celo network. This will allow interaction with the Celo Protocol and manage Celo Gold holdings.

If you haven’t already, check out our Step-By-Step cGLD Ledger Tutorial.

The official CeloCLI documentation can be found here: Introduction — Celo Docs.

Quick reference:

  1. Connecting to a Celo node
  2. Generating Celo addresses
  3. Checking your account and locked token balance
  4. Sending transactions of cGLD or cUSD
  5. Staking cGLD tokens

Connecting to a Celo node

celocli config:set --node https://rc1-forno.celo-testnet.org/

Generating Celo addresses

Generate the first address of the ledger by running the following command:

celocli account:list --useLedger --ledgerAddresses 1

This outputs both the account that is present on the Celo node, and also the Ledger’s address. The outputs will be categorised as follows, so as to not confuse between the node (Keystore) and Ledger addresses.

Image for post
Image for post
Example query: Generating 1 Celo address from a Ledger Nano

Changing the ledgerAddresses parameter will produce further addresses:

Image for post
Image for post
Example query: Generating 5 Celo addresses from a Ledger Nano

Checking your account and locked token balance

celocli account:balance <your-address>
Image for post
Image for post
Example query: Checking an address’ balance

Sending transactions of cGLD or cUSD

celocli transfer:gold --from=<your-address> --to=<to-address> --value=<amount> --useLedger --ledgerAddresses Xcelocli transfer:dollars --from=<your-address> --to=<to-address> --value=<amount> --useLedger --ledgerAddresses X

Example transaction:

Image for post
Image for post
Example transaction: Sending a Celo Gold transactions

Staking cGLD tokens

  1. Register your account to be able to lock Celo Gold and participate in the Celo Protocol operations.
celocli account:register --from <your-address> --ledgerAddresses=1 --useLedger

2. Locking your cGLD tokens. Make sure to leave at least 5 cGLD unlocked for fees.

celocli lockedgold:lock --from <your-address> --value <number> --ledgerAddresses=1 --useLedger
Image for post
Image for post
Example transaction: Lock an amount of cGLD

3. Ensure the Gold was locked successfully.

celocli lockedgold:show <your-address> --ledgerAddresses=1 --useLedger
Image for post
Image for post
Example query: Checking an account’s locked gold status

4. Vote for your preferred Validator Group. The Validator Group must have an elected validator to earn rewards from voting your Celo Gold.

celocli election:vote --from <your-address> --for <validator-group-address> --value 1000000 --ledgerAddresses=1 --useLedger
Image for post
Image for post
Example transaction: Voting for a validator group

If you’re looking for a Validator Group to vote for, our Simply Staking validator group ( 0xAcdf897493A6000dbe256791E8A2beCbb405FD4F ) incorporates validators operated from our private and security-focused datacentre in Malta, led by a team with years of experience operating within the blockchain space.

5. Votes must be activated after the epoch in which they are submitted, to begin earning rewards. Epochs on Celo currently last 24 hours. This means that this command must be run 24+ hours after casting of votes.

celocli election:activate --from <your-address> --ledgerAddresses=1 --useLedger

Trying to activate votes prior to the current epoch ending will result in the following message:

Image for post
Image for post
Example transaction: Activating an account’s election votes

6. Confirm votes were cast by checking your account’s election votes cast.

celocli election:show 0x97f7333c51897469E8D98E7af8653aAb468050a3 --voter
Image for post
Image for post
Example query: Checking an account’s voting status

I hope you find this step-by-step guide useful! I would be happy to hear your thoughts and answer any questions on Twitter https://twitter.com/cremonafran.

Stay tuned to Simply VC for more Celo guides and documentation:

Find out more about Celo:

Simply VC

A team of security, cryptocurrency & business experts…

Medium is an open platform where 170 million readers come to find insightful and dynamic thinking. Here, expert and undiscovered voices alike dive into the heart of any topic and bring new ideas to the surface. Learn more

Follow the writers, publications, and topics that matter to you, and you’ll see them on your homepage and in your inbox. Explore

If you have a story to tell, knowledge to share, or a perspective to offer — welcome home. It’s easy and free to post your thinking on any topic. Write on Medium

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store