> ## Documentation Index
> Fetch the complete documentation index at: https://docs.celo.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Celo

> Celo is a leading Ethereum L2. As the frontier chain for global impact, we're scaling real-world solutions for all.

export const AddNetworkButton = ({network = "mainnet"}) => {
  const NETWORKS = {
    mainnet: {
      title: "Add Celo Mainnet to your wallet",
      desc: "Chain ID 42220 · CELO",
      params: {
        chainId: "0xa4ec",
        chainName: "Celo Mainnet",
        nativeCurrency: {
          name: "Celo",
          symbol: "CELO",
          decimals: 18
        },
        rpcUrls: ["https://forno.celo.org"],
        blockExplorerUrls: ["https://celoscan.io"]
      }
    },
    sepolia: {
      title: "Add Celo Sepolia to your wallet",
      desc: "Chain ID 11142220 · Testnet",
      params: {
        chainId: "0xaa044c",
        chainName: "Celo Sepolia",
        nativeCurrency: {
          name: "Celo",
          symbol: "CELO",
          decimals: 18
        },
        rpcUrls: ["https://forno.celo-sepolia.celo-testnet.org"],
        blockExplorerUrls: ["https://celo-sepolia.blockscout.com"]
      }
    }
  };
  const cfg = NETWORKS[network] || NETWORKS.mainnet;
  const [status, setStatus] = useState(null);
  const [pending, setPending] = useState(false);
  const handleClick = async () => {
    setStatus(null);
    const eth = window.ethereum;
    const provider = eth && Array.isArray(eth.providers) && eth.providers.length ? eth.providers.find(p => p && p.isMetaMask) || eth.providers[0] : eth;
    if (!provider || !provider.request) {
      setStatus({
        kind: "info",
        text: "No browser wallet detected. Install MetaMask, then try again."
      });
      return;
    }
    setPending(true);
    try {
      await provider.request({
        method: "wallet_addEthereumChain",
        params: [cfg.params]
      });
      setStatus({
        kind: "success",
        text: `${cfg.params.chainName} added to your wallet.`
      });
    } catch (err) {
      console.error("wallet_addEthereumChain failed", err);
      const text = err && err.code === 4001 ? "Request cancelled in your wallet." : `Couldn't add the network${err && err.message ? `: ${err.message}` : "."}`;
      setStatus({
        kind: "error",
        text
      });
    } finally {
      setPending(false);
    }
  };
  const descText = pending ? "Opening your wallet…" : status ? status.text : cfg.desc;
  const descColor = status && status.kind === "error" ? "text-red-600 dark:text-red-400" : status && status.kind === "success" ? "text-primary dark:text-primary-light" : "text-gray-600 dark:text-gray-400";
  return <button type="button" onClick={handleClick} disabled={pending} aria-label={cfg.title} className="card block font-normal group relative my-2 ring-2 ring-transparent rounded-2xl bg-white dark:!bg-[#0b0d10] border border-gray-950/10 dark:border-white/10 overflow-hidden w-full text-left cursor-pointer hover:!border-primary dark:hover:!border-primary-light disabled:cursor-not-allowed">
      <div className="px-6 py-5 relative">
        <div className="h-6 w-6 text-primary dark:text-primary-light">
          <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" className="h-6 w-6 shrink-0" aria-hidden="true">
            <circle cx="12" cy="12" r="10" />
            <path d="M8 12h8" />
            <path d="M12 8v8" />
          </svg>
        </div>
        <div>
          <h2 className="not-prose font-semibold text-base text-gray-800 dark:text-white mt-4">
            {cfg.title}
          </h2>
          <div className={`prose mt-1 font-normal text-base leading-6 ${descColor}`}>
            <span>{descText}</span>
          </div>
        </div>
      </div>
    </button>;
};

<Card title="Start Building" icon="rocket" href="/build-on-celo/build-with-ai/celopedia">
  Build your first app on Celo. No coding experience required.
</Card>

***

## AI Agent Infrastructure

<CardGroup cols={2}>
  <Card title="ERC-8004: Agent Trust" icon="shield-check" href="/build-on-celo/build-with-ai/8004">
    Establish trust infrastructure for autonomous AI agents with identity, reputation, and validation registries.
  </Card>

  <Card title="x402: Agent Payments" icon="money-bill-transfer" href="/build-on-celo/build-with-ai/x402">
    Enable instant, permissionless micropayments for AI agents using stablecoins via HTTP 402.
  </Card>

  <Card title="MPP: Machine Payments" icon="credit-card" href="/build-on-celo/build-with-ai/mpp">
    Charge USDC per API request over HTTP — gasless for the buyer, settled on-chain via a hosted facilitator.
  </Card>

  <Card title="Celopedia: Celo Skill" icon="book-open" href="https://celopedia.celo.org/">
    Give your coding assistant Celo ecosystem knowledge — contract addresses, MiniPay, DeFi, grants, and agent infrastructure.
  </Card>
</CardGroup>

## Real World Use Cases

<CardGroup cols={2}>
  <Card title="Mini Apps" icon="grid-2" href="/build-on-celo/build-on-minipay/overview">
    Build apps that scale to millions of global mobile wallet users via MiniPay.
  </Card>

  <Card title="Local Stablecoins" icon="coin-blank" href="/build-on-celo/build-with-local-stablecoin">
    Create low-cost FX and payment apps via Mento’s 25+ local digital currencies.
  </Card>

  <Card title="AI Agents" icon="robot" href="/build-on-celo/build-with-ai/overview">
    Launch AI agents, use MCP servers, and build intelligent applications for the onchain economy with Celo's AI-focused tools and frameworks.
  </Card>

  <Card title="ZK Identity" icon="passport" href="/build-on-celo/build-with-self">
    Prove users’ humanity and unique identity without compromising privacy via Self Protocol.
  </Card>
</CardGroup>

## Builder Support

<CardGroup cols={2}>
  <Card title="Build on Celo" icon="wrench" href="/build-on-celo">
    Explore comprehensive guides, tutorials, and tools to build dApps, DeFi protocols, mobile apps, and more on Celo's fast, low-cost blockchain.
  </Card>

  <Card title="Fund your Project" icon="dollar-sign" href="/build-on-celo/fund-your-project">
    Discover grant opportunities and funding sources available in the Celo ecosystem.
  </Card>
</CardGroup>

## Add Celo to your wallet

Connect your browser wallet to Celo in one click. See all network details on the [Network Information](/build-on-celo/network-overview) page.

<div className="grid gap-x-4 gap-y-2 sm:grid-cols-2 mt-4">
  <AddNetworkButton network="mainnet" />

  <AddNetworkButton network="sepolia" />
</div>

## Explore Developer Tools & Resources

<AccordionGroup>
  <Accordion title="Understanding Celo">
    <CardGroup cols={2}>
      <Card title="What is Celo?" icon="circle-info" href="/home/index">
        Discover how Celo L2 is scaling real world use cases on Ethereum
      </Card>

      <Card title="Architecture" icon="layer-group" href="/build-on-celo/cel2-architecture">
        Overview of our stack and core contracts
      </Card>

      <Card title="Whitepapers" icon="file" href="https://celo.org/papers">
        Dive in to understand our protocol and social impact
      </Card>

      <Card title="Protocol" icon="sitemap" href="/home/protocol">
        Learn about our protocol and its relationship to Ethereum
      </Card>
    </CardGroup>
  </Accordion>

  {" "}

  <Accordion title="Build with Celo">
    <CardGroup cols={2}>
      <Card title="Quickstart" icon="bolt" href="/build-on-celo/build-with-ai/celopedia">
        Build & Deploy your dApps in under 5 minutes
      </Card>

      <Card title="Tutorials" icon="graduation-cap" href="/build-on-celo">
        Explore Celo Tutorials
      </Card>

      <Card title="Integrate" icon="plug" href="/build-on-celo/network-overview">
        Connect Celo to your application
      </Card>
    </CardGroup>
  </Accordion>

  {" "}

  <Accordion title="Developer Tools">
    <CardGroup cols={2}>
      <Card title="Faucet" icon="droplet" href="https://faucet.celo.org">
        Get testnet tokens for development
      </Card>

      <Card title="Explorer" icon="search" href="/tooling/explorers/overview">
        Explore transactions on Celo
      </Card>

      <Card title="Bridge" icon="bridge" href="/home/bridged-tokens/bridges">
        Bridge Assets across chains
      </Card>

      <Card title="Deploy" icon="upload" href="/tooling/dev-environments">
        Deploy your contract on Celo
      </Card>
    </CardGroup>
  </Accordion>

  <Accordion title="Grow Your Project">
    <CardGroup cols={2}>
      <Card title="Get Funding" icon="dollar-sign" href="/build-on-celo/fund-your-project">
        Discover grant opportunities in the Celo ecosystem
      </Card>

      <Card title="Distribution" icon="megaphone" href="/build-on-celo/launch-checklist">
        Get more awareness about your project
      </Card>
    </CardGroup>
  </Accordion>
</AccordionGroup>

***

## Join the Celo Builder Ecosystem

<Info>
  💡 Discover the many ways to connect with our growing community of developers
</Info>

<CardGroup cols={2}>
  <Card title="Join the Newsletter" icon="envelope" href="https://embeds.beehiiv.com/eeadfef4-2f0c-45ce-801c-b920827d5cd2">
    Stay updated on the latest news, grants, and opportunities
  </Card>

  <Card title="Connect with the Community" icon="discord" href="https://discord.com/invite/celo">
    Join our Discord
  </Card>

  <Card title="Governance Events" icon="lightbulb" href="https://lemonade.social/s/celogovernance">
    Sign up for upcoming governance calls and workshops
  </Card>

  <Card title="Join Proof of Ship" icon="anchor" href="https://celoplatform.notion.site/Build-With-Celo-Proof-of-Ship-17cd5cb803de8060ba10d22a72b549f8">
    Build your onchain reputation to unlock exclusive rewards
  </Card>

  <Card title="Make your Voice Heard" icon="check-to-slot" href="/home/protocol/governance/voting-in-governance-using-mondo">
    Vote on Governance Proposals
  </Card>

  <Card title="Get Daily Updates" icon="x-twitter" href="https://x.com/CeloDevs">
    Follow our CeloDev on X
  </Card>
</CardGroup>

***

<Tip>
  New to Celo? Start with the [Celo Overview](/home) for a complete introduction to the platform.
</Tip>
