Celo Developer Documentation

website·Indexed 39 days ago

https://docs.celo.org/

Guides and technical references for building on Celo, featuring L2 architecture, fee abstraction for paying gas in stablecoins, and AI agent integration via the Model Context Protocol (MCP), ERC-8004, and the Machine Payments Protocol (MPP). Includes documentation for MiniPay, SocialConnect, and the Nightfall privacy layer.

Tokens
144.7K
Snippets
574
Records
1.1K
Agent score
71%

What's inside Celo

  1. Overview of Celo Attribution Tags (ERC-8021)

    Attribution tags allow developers to mark on-chain transactions as originating from their specific app. This is used for tracking activity in programs like hackathons or leaderboards. Celo implements the ERC-8021 standard, which appends a suffix to the transaction's calldata. Because the EVM discards trailing bytes, this suffix does not change the execution semantics of the contract call but remains visible to off-chain indexers.
  2. Overview of the Celo Escrow contract

    The Escrow contract enables payments to be sent to users who do not yet possess a public/private key pair or a blockchain address. It leverages Celo's Lightweight identity feature (supporting both identifier-based and privacy-based versions). Payments are held within the contract and can be either withdrawn by the intended recipient or reclaimed by the sender if the payment expires.
  3. Overview of Celo Global Ramps

    Celo provides a network of on-ramps and off-ramps to bridge traditional finance (TradFi) and decentralized finance (DeFi). On-ramps allow users to purchase cryptocurrencies using traditional payment methods (bank transfers, cards, mobile money), while off-ramps allow users to convert digital assets back to fiat currency for withdrawal to bank accounts or mobile wallets. The ecosystem covers 127+ countries with a focus on financial inclusion in emerging markets.
  4. Overview of Celo Ethereum Layer 2

    Celo is an Ethereum Layer-2 blockchain designed for scalability, low fees, and ease of use. It is fully EVM-compatible, providing the same development experience as Ethereum but with improved performance and lower costs, making it suitable for building products aimed at global, real-world adoption.
  5. Overview of Celo L2 Epoch Rewards

    Epoch Rewards are incentives distributed in CELO tokens at the end of each epoch (approximately every 24 hours). A total of 400 million CELO is allocated for these rewards. The rewards are distributed to the following participants:

    • Community RPC providers (node operators)
    • Locked CELO holders (users voting for groups that elected RPC providers)
    • Community Fund (infrastructure grants)
    • Carbon Offsetting Fund (environmental initiatives)
  6. Overview of Celo Metadata and Claims

    Celo allows accounts to connect on-chain identities with off-chain information (such as names, profile pictures, or RPC URLs) using signed metadata files. These files are hosted off-chain, and the URL to the file is registered on the Accounts smart contract. This system supports both verifiable claims (proven via external sources like DNS or Keybase) and non-verifiable claims.
  7. Overview of the Jello Upgrade for Celo

    The Jello upgrade enables OP Succinct Lite on the Celo network. OP Succinct Lite is a production-ready, zero-knowledge-powered fault proof system developed in collaboration with OP Labs and Succinct.
  8. Overview of building on Celo L2

    Celo is an Ethereum Layer 2 (L2) solution that is fully EVM-compatible, providing the same development experience as Ethereum but with improved scalability and lower costs. Key technical advantages include 1-second block finality, sub-cent transaction fees, and native stablecoin support. It is designed for real-world use cases, featuring fee abstraction and distribution via MiniPay.
  9. Overview of AI Agents on Celo

    Celo is an Ethereum Layer 2 optimized for AI agents that require real-world utility, such as autonomous on-chain actions tied to payments, commerce, and financial coordination. AI agents on Celo are software systems capable of observing on-chain/off-chain data, making decisions via AI models or logic, and executing transactions autonomously. They can interact with DeFi protocols, manage balances, and coordinate activity across users and applications using stablecoins.
  10. Overview of Celo On-chain Governance

    Celo uses a formal on-chain governance mechanism to manage and upgrade the protocol, including upgrading smart contracts, adding new stable currencies, and modifying reserve target asset allocations. All changes must be agreed upon by CELO holders. The process is managed via the Governance smart contract, which acts as the owner for other 'governable' protocol smart contracts.
  11. Overview of Model Context Protocol (MCP)

    The Model Context Protocol (MCP) is an open standard developed by Anthropic that standardizes how applications provide context to Large Language Models (LLMs). It enables AI models to connect consistently and efficiently with various data sources and tools. MCP is widely adopted across AI platforms and IDEs, including VS Code, Cursor, JetBrains, Windsurf, Zed, OpenAI's Agents SDK, and the ChatGPT desktop app.
  12. Overview of Celo Oracles for Mento

    Oracles for the Mento stability protocol are clients that fetch price data for CELO/USD, CELO/EUR, and CELO/BRL from centralized exchanges (CEX) and push them on-chain. They interact with the blockchain by calling the SortedOracles.report(address token, uint256 value, address lesserKey, address greaterKey) method on the Celo Core Contract.