This page serves as a checklist for applications building and integrating on Celo. Using common features and standards across applications in the Celo ecosystem will lead to a superior user experience.
Addresses are identical to Ethereum addresses. When displaying and asking for user-inputted addresses, consider using and validating address checksums following the EIP55 standard to detect typos.
For core smart contracts, developers are highly encouraged to use the Registry to reference the contracts in case they will have to be repointed (via Governance)
Celo has WIP QR code standard CIP16 that aims to standardize how applications can ask wallets for transactions to avoid the user having to manually copy/paste addresses and other transaction metadata.
Please read more under Custody, but here is a shortened version:
Stable-value currencies, currently just cUSD, is a contract
StableToken that can be accessed via the ERC20 interface. The native asset CELO can be accessed via the
GoldToken ERC20 interface, or natively, similar to ETH on Ethereum.
Users may want to participate in Celo's Proof of Stake system to help secure the network and earn rewards.
Celo's core smart contracts use Celo's
Accounts abstraction to allow balance-moving keys to be held in cold storage, while other keys can be authorized to vote and be held in warm storage or online.
There is an audited
ReleaseGold smart contract which allows for the release of CELO over a set schedule through which CELO might be distributed to a user.
These suggestions apply to any application that custodies a key and allows users to interact and transfer value on the Celo platform.
Celo wallets should follow the BIP44 for deriving private keys from BIP39 mnemonics. Celo's key derivation path is at
m/44'/52752'/0'/0. The first key typically is the
account key that wallets should register themselves with and accept balance transfers on. The second key can be derived to be an account's
dataEncryptionKey to allow other users on Celo to encrypt information to.
Celo has a lightweight identity protocol that allows users to address each other via their phone number instead of addressses that Celo wallets should implement. Since user privacy is important, Celo wallets should leverage the built-in Phone Number Privacy protocol to protect against large-scale harvesting of user phone numbers.
When transferring assets to an account, wallets should check the receiving account's
walletAddress at which they want to receive funds at. Use cases might be smart contract accounts that want different recovery characteristics, but receive funds at a different address. Also,
0x0 should indicate that the account requires a different mechanism to acquire the
cUSD (aka StableToken) adds an additional method to the ERC20 interface called
transferWithComment which allows senders to specify an additional comment that Celo wallets should support. Additionally, comments should be encrypted to the
dataEncryptionKey when applicable.
The Celo ecosystem relies on a diverse set of applications to be built so that users can interact with them. To ensure interopebility and avoid fragmentation due to proprietary interfaces, wallets should be implementing the deeplink-based dappkit to have a consistent interface for dapp developers to implement.
Validator Group Explorers are critical to Celo's Proof of Stake system. Explorers will consider using the following standards to provide a minimum experience across all explorers.
All Celo accounts on
Accounts.sol can claim any name they want. While explorers should display it, they should also be coignizant of the fraud potential.
Celo accounts can make claims to existing identities, some of which are verifiable (Domain Names or Keybase profiles). Explorers should consider displaying those identities to reduce the potential for impersonation.
Validator Groups and their validators can perform their duties differently and explorers should reflect that to allow voters to ensure an optimal validator set. While uptime in the form of block signatures by the validators ultimately affect rewards, explorers should also consider displaying other metrics that impact the success of the Celo ecosystem, such as validators' performance in the identity protocol.