EVM-Compatible β’ Mobile-First β’ Carbon Negative Blockchain
This guide shows you how to integrate Celo networks (Celo Mainnet and Alfajores testnet) into your Bicrypto Ecosystem. You'll add Celo credentials in .env, acquire API/RPC endpoints, then set up wallets and tokens in the admin panelβsimilar to how it's done for other EVM-compatible chains like Ethereum, BSC, or Polygon.
# Celo Networks (mainnet, alfajores)
CELO_EXPLORER_API_KEY="YOUR_CELO_EXPLORER_API_KEY" # e.g., ZZSQAPGRGS5Q2UENI...
CELO_NETWORK="alfajores"
CELO_MAINNET_RPC="https://YOUR_MAINNET_RPC_PLACEHOLDER"
CELO_MAINNET_RPC_WSS=""
CELO_ALFAJORES_RPC="https://YOUR_ALFAJORES_RPC_PLACEHOLDER"
CELO_ALFAJORES_RPC_WSS=""
mainnet or alfajores)If you're using a specific Celo explorer, create an account and generate an API key:
CELO_EXPLORER_API_KEY
By default, Celo provides:
forno.celo.orgalfajores-forno.celo-testnet.orgIf you use another provider (e.g., GetBlock), replace the placeholder URLs with your provider's endpoints.
CELO_NETWORK to alfajores for testing or mainnet for production use.
Generate a New Master Wallet for the enabled Celo network (mainnet or Alfajores). This wallet handles native fees (CELO) and any tokens that allow "permit" features on Celo.
Enable tokens you plan to use for markets on Celo (e.g., cUSD, cEUR, etc.) and configure their fees and limits appropriately.
Some tokens don't support the PERMIT feature (where fees can be deducted from the user's own wallet). In this case, the platform uses a Custodial Wallet:
Ensure the master wallet has sufficient CELO to cover gas fees and deployments.
Go to Admin β Extensions β Ecosystem β Custodial Wallets to deploy a new custodial wallet specifically for Celo.
Users' token deposits/withdrawals are processed via this custodial wallet, with CELO as the native fee currency.
The main coin on the Celo network is CELO. Required to pay network fees on standard transactions.
A token with advanced smart contract features allowing the user's own wallet to let the platform pay fees from that same wallet. The user doesn't need CELO for each transaction.
Tokens lacking these features require a custodial wallet. The master wallet pays gas fees for withdrawals.
Celo gas fees are typically low, but can still vary. Adjust your minimum fees accordingly to ensure profitable operations.
For testing, set CELO_NETWORK to alfajores and provide testnet RPC endpoints. You can get test CELO from an Alfajores faucet.
If adding other chains, follow a similar pattern with environment variables and network settings.