Access and account management for holding, exchanging, or sending Celo Dollars (cUSD) and stablecoins.
This guide assumes:
Choose a Node
Create an Account
There are two ways to create an account:
- (Recommended) use accounts generated by Ledger, if you possess a Ledger hardware wallet
- Use CLI to generate an account -- this approach is less secure and hence not recommended
After creating an account, record its address in environment variables:
Exchange CELO for Stablecoins
Once you have deposited CELO to your account, you can check your balance:
celocli account:balance $CELO_ACCOUNT_ADDRESS
As an example of a common stablecoin swap, you can exchange CELO for cUSD using the following command. This exchanges CELO for stable tokens (cUSD by default) via the stability mechanism. Note that the unit of value is CELO Wei (1 CELO = 10^18 CELO Wei).
celocli exchange:celo --value <VALUE-TO-EXCHANGE> --from $CELO_ACCOUNT_ADDRESS
When you have sufficient balance, you can send stablecoins such as cUSD to other accounts. Note that the unit of value is cUSD Wei (1 cUSD = 10^18 cUSD Wei).
celocli transfer:dollars --from $CELO_ACCOUNT_ADDRESS --to <RECIPIENT-ADDRESS> --value <VALUE-TO-TRANSFER>