Install the Celo CLI
Open the terminal application on your computer and install the Celo CLI:Configure the network
Connecting celocli to an untrusted node may allow that node to influence the transactions sent by the Celo CLI to the Ledger for signing. When in doubt, always use a node that you trust or are running yourself.
Configure the Celo CLI so that it uses a cLabs node on the Celo network.
Check that the node is synchronized to Celo CLI:
true
. If it displays false
you may need to wait a bit and try again.
Confirm Addresses on Celo CLI
The Ledgerâs current seed phrase determines the deviceâs accounts. In the terminal on your computer, you can view the first accountâs address with the following command:If you wish to generate more than one address from your seed phrase, you can display the first To display addresses at specific indexes
N
(e.g. 10) addresses use the --ledgerAddresses
flag.M
and N
(e. 2 and 654) use the --ledgerCustomAddresses "[M, N]"
flagAdvanced: Celo uses a BIP-32 derivation path of
m/44'/52752'/0'/0/index
, where index >= 0
.Performing a Testnet transaction on Celo CLI
Before using your address on the Celo Mainnet, you may want to test it on the Celo Alfajores Testnet with the following instructions. Visit the Celo Sepolia Faucet and send yourself some testnet CELO at the following URL: https://faucet.celo.org/celo-sepolia Check that you received the funds with the following command:Approve
on screen. Press both buttons at the same time to confirm.
Finally, you can see if your transaction was mined on the network by copying the transaction hash (txHash) outputted by the command, and searching for it on the Alfajores Block Explorer.
Using celocli
You can use celocli
to securely sign transactions or proof-of-possessions with your Ledger.
To use celocli
with your Ledger, ensure the device is connected to your computer, unlocked, and the Celo
app is open and displaying Application is ready
.
Then, simply append the --useLedger
flag to any celocli
commands with which youâd like to use a Ledger. You may also append the --ledgerConfirmAddress
flag, which will require that you manually verify on the Ledger the address from which the transaction is being sent.
View Account Balance
In order to view your account Balance on your Ledger withcelocli
, you need to run the following command:
Receive Crypto Assets
In order to receive Celo on your address, whether itâs CELO or cUSD or any Mento stablecoin in the future, you must share your specific address with the sender. Once a sender has confirmed they sent you the assets to your Ledger address, ask for the transaction ID which you can lookup on the Explorer.Send Crypto Assets
In order to send CELO or cUSD from your Ledger, you just need a recipient address to send to. Once you have that and the amount you would like to send (in our example, 10 CELO), we will go over how to send CELO usingcelocli
.
Approve
on screen. Press both buttons at the same time to confirm.
Youâll then get a transaction hash when itâs confirmed that the transaction was mined by the network, and you can check the status of the transaction on the explorer here.
Troubleshooting
If you have issues connecting to the Ledger, try the following:- Check that the Ledger device is connected, powered on, and that youâve unlocked it using the PIN.
- Check that no other applications are using the device. Close Ledger Live. Stop any local Celo Blockchain node, or ensure it is run with the
--usb
option. - Try unplugging and replugging the device. Some devices appear to trigger a warning on Macs saying: âUSB Devices Disabled. Unplug the device using too much power to re-enable USB devicesâ which is usually resolved by reconnecting.
- Ensure that you are using the original cable supplied with your Ledger.
- Ensure that your Ledger has the latest firmware. For Ledger Nano S, a firmware version of 1.6 or later is required.
- Ensure that you are running the latest version of the Celo CLI.
Pending Ledger review
notice too rapidly can cause the device to freeze. If this occurs, wait until the deviceâs battery is depleted, then charge and power up again. Then use Ledger Live Manager to update the installed version of the Celo Ledger App.