diff --git a/build-on-celo/build-with-ai/celopedia.mdx b/build-on-celo/build-with-ai/celopedia.mdx index 3211927fd..3e3509140 100644 --- a/build-on-celo/build-with-ai/celopedia.mdx +++ b/build-on-celo/build-with-ai/celopedia.mdx @@ -1,79 +1,64 @@ --- title: "Celopedia" sidebarTitle: "Celopedia (Skill)" -description: "Use Celopedia to query Celo ecosystem data, protocol references, contract addresses, MiniPay guidance, DeFi protocols, grants, and AI agent infrastructure from your coding assistant." +og:description: "Celopedia gives your AI coding assistant deep Celo knowledge — so you can find an idea, shape it, get feedback, and ship on Celo without leaving your editor." --- -Celopedia is a builder-focused knowledge skill for Celo. It packages Celo ecosystem intelligence, protocol references, verified contract addresses, MiniPay guidance, DeFi protocol context, grant information, and AI agent infrastructure into a skill that coding assistants can use while you build. +**Your AI coding assistant, now fluent in Celo.** Celopedia is a knowledge skill that plugs verified Celo intelligence — contract addresses, protocols, MiniPay, grants, and agent infrastructure — straight into the tools you already build with. -Use it when you want your AI coding agent to answer Celo-specific questions, compare ecosystem opportunities, find contract addresses, scaffold common development patterns, or reason about MiniPay, DeFi, stablecoins, governance, and agentic applications on Celo. +Go from "what should I build?" to a live dApp without tab-hopping through docs. -## What you can do with Celopedia + + + Search live ecosystem data to spot the gaps and opportunities worth building. + + + Compare verticals, pick the right protocols, and scope an architecture that fits Celo. + + + Pressure-test as you go — how saturated is this market, how does my approach compare? + + + Grab contract addresses, MiniPay and fee-abstraction patterns, and deploy — all in your editor. + + -- **Research ecosystem opportunities**: Search ecosystem data, compare verticals, and identify gaps before you build. -- **Find contract addresses**: Look up verified addresses for core protocol contracts, Mento stablecoins, Uniswap, Aave, Morpho, bridge contracts, and more. -- **Build MiniPay apps**: Get MiniPay wallet detection, payment, testing, and submission guidance. -- **Integrate DeFi protocols**: Ask for Celo-specific patterns for protocols such as Uniswap, Aave, Morpho, Mento, Velodrome, Curve, Ubeswap, and stCELO. -- **Explore grants and funding**: Match a project idea to relevant Celo grant programs and builder support options. -- **Build AI agents on Celo**: Use references for ERC-8004, x402, the Celo MCP Server, and agent skills. +## Install Celopedia -## Install - -Install Celopedia with `npx skills`: +Add it to your coding assistant with one command: ```bash npx skills add celo-org/celopedia-skills ``` -After installing, restart your coding assistant if it does not discover new skills during an active session. - - Celopedia supports agent environments that use file-based skills, including Codex, Claude Code, and OpenClaw. See the GitHub repository for tool-specific install notes. + Restart your coding assistant afterward if it doesn't discover new skills mid-session. Celopedia works with file-based skill environments including Codex, Claude Code, and OpenClaw — see the [GitHub repository](https://github.com/celo-org/celopedia-skills) for tool-specific install notes. -## Example prompts - -Once installed, ask your coding assistant questions like: +## Try it -```text -What lending protocols exist on Celo? -``` +Once installed, ask your assistant things like: ```text +What lending protocols exist on Celo, and which vertical is least saturated? Give me the Uniswap V4 contract addresses on Celo mainnet. -``` - -```text -I want to build a payments Mini App. Show me the recommended architecture. -``` - -```text -What grants can I apply to for a DeFi project on Celo? -``` - -```text +Scaffold a payments Mini App with the recommended architecture. Set up a Foundry project for Celo with fee abstraction. ``` -```text -How saturated is the DEX vertical on Celo compared with other EVM chains? -``` - -## What's included - -| Area | Included references | -|------|---------------------| -| Network and contracts | Chain IDs, RPCs, explorers, fee currencies, RPC limits, and verified contract addresses | -| Ecosystem intelligence | Product discovery, competitor scans, vertical analysis, and Celo ecosystem context | -| Builder setup | Foundry, Hardhat, Viem, Wagmi, fee abstraction, deployment, and verification patterns | -| DeFi | Protocol references for Uniswap, Aave, Morpho, Mento, Velodrome, Curve, Ubeswap, and stCELO | -| MiniPay | Mini App development, wallet detection, stablecoin payments, ODIS, templates, and listing guidance | -| AI agents | ERC-8004, x402, Celo MCP Server, and agent skill references | -| Grants | Funding programs and grant matchmaking guidance | +## What's inside -## Data sources +| Area | What you get | +|------|--------------| +| Network & contracts | Chain IDs, RPCs, explorers, fee currencies, and verified contract addresses | +| Ecosystem intelligence | Product discovery, competitor scans, and vertical analysis | +| Builder setup | Foundry, Hardhat, Viem, Wagmi, fee abstraction, and deploy & verify patterns | +| DeFi | References for Uniswap, Aave, Morpho, Mento, Velodrome, Curve, Ubeswap, and stCELO | +| MiniPay | Wallet detection, stablecoin payments, ODIS, templates, and listing guidance | +| AI agents | ERC-8004, x402, the Celo MCP Server, and agent skill references | +| Grants | Funding programs and grant matchmaking | -Celopedia is curated from official Celo documentation, protocol references, ecosystem data sources, and live public APIs where applicable. Its sources include Celo Docs, The Grid, DefiLlama, Celoscan, MiniPay references, and protocol documentation from teams across the Celo ecosystem. +Celopedia is curated from official Celo documentation, protocol references, and live public data sources including Celo Docs, The Grid, DefiLlama, and Celoscan. ## Resources diff --git a/build-on-celo/index.mdx b/build-on-celo/index.mdx index a33e281ac..0bb237423 100644 --- a/build-on-celo/index.mdx +++ b/build-on-celo/index.mdx @@ -21,8 +21,8 @@ Whether you're building your first dApp or looking to integrate an existing prot ## Getting Started - - Quickstart with Celo Composer CLI + + Get started fast with Celopedia Deploy a smart contract on Celo diff --git a/build-on-celo/network-overview.mdx b/build-on-celo/network-overview.mdx index 612859200..393d97898 100644 --- a/build-on-celo/network-overview.mdx +++ b/build-on-celo/network-overview.mdx @@ -3,6 +3,8 @@ title: Network Information og:description: How to choose a Celo network based on your needs and objectives. --- +import { AddNetworkButton } from '/snippets/AddNetworkButton.jsx'; + Overview of Celo Mainnet and the Celo Sepolia Testnet. --- @@ -20,7 +22,7 @@ Overview of Celo Mainnet and the Celo Sepolia Testnet. | Block Explorers |
  • [https://explorer.celo.org](https://explorer.celo.org)
  • [https://celoscan.io](https://celoscan.io)
| | Bridge Link | [List of bridges](/developer/bridges/bridges) | -::: + ## Celo Sepolia Testnet @@ -37,6 +39,8 @@ Overview of Celo Mainnet and the Celo Sepolia Testnet. | Bridge Link | [https://testnets.superbridge.app](https://testnets.superbridge.app/?fromChainId=11155111&toChainId=11142220)
Note: Ensure you enable Testnet in settings | | Faucet Links |
  • [https://cloud.google.com/application/web3/faucet/celo/sepolia](https://cloud.google.com/application/web3/faucet/celo/sepolia)
  • [https://faucet.celo.org/celo-sepolia](https://faucet.celo.org/celo-sepolia)
| + + The Celo Sepolia Testnet is Celo's new developer testnet built on Ethereum Sepolia, designed to replace Alfajores following the planned Holesky deprecation in September 2025. **Key Features:** diff --git a/home/celo.mdx b/home/celo.mdx index 849f36b2b..90ff4f83a 100644 --- a/home/celo.mdx +++ b/home/celo.mdx @@ -3,12 +3,31 @@ title: "Celo" description: "Celo is a leading Ethereum L2. As the frontier chain for global impact, we're scaling real-world solutions for all." --- - +import { AddNetworkButton } from '/snippets/AddNetworkButton.jsx'; + + Build your first app on Celo. No coding experience required. --- +## AI Agent Infrastructure + + + + Establish trust infrastructure for autonomous AI agents with identity, reputation, and validation registries. + + + Enable instant, permissionless micropayments for AI agents using stablecoins via HTTP 402. + + + Charge USDC per API request over HTTP — gasless for the buyer, settled on-chain via a hosted facilitator. + + + Give your coding assistant Celo ecosystem knowledge — contract addresses, MiniPay, DeFi, grants, and agent infrastructure. + + + ## Real World Use Cases @@ -26,20 +45,6 @@ description: "Celo is a leading Ethereum L2. As the frontier chain for global im -## AI Agent Infrastructure - - - - Establish trust infrastructure for autonomous AI agents with identity, reputation, and validation registries. - - - Enable instant, permissionless micropayments for AI agents using stablecoins via HTTP 402. - - - Charge USDC per API request over HTTP — gasless for the buyer, settled on-chain via a hosted facilitator. - - - ## Builder Support @@ -51,6 +56,15 @@ description: "Celo is a leading Ethereum L2. As the frontier chain for global im +## 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. + +
+ + +
+ ## Explore Developer Tools & Resources @@ -74,7 +88,7 @@ description: "Celo is a leading Ethereum L2. As the frontier chain for global im - + Build & Deploy your dApps in under 5 minutes diff --git a/snippets/AddNetworkButton.jsx b/snippets/AddNetworkButton.jsx new file mode 100644 index 000000000..64fdca11a --- /dev/null +++ b/snippets/AddNetworkButton.jsx @@ -0,0 +1,123 @@ +export const AddNetworkButton = ({ network = "mainnet" }) => { + // Single source of truth for Celo network wallet_addEthereumChain params. + const NETWORKS = { + mainnet: { + title: "Add Celo Mainnet to your wallet", + desc: "Chain ID 42220 · CELO", + params: { + chainId: "0xa4ec", // 42220 + 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", // 11142220 (lowercase hex — MetaMask rejects uppercase) + 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); // { kind: "success" | "error" | "info", text } + const [pending, setPending] = useState(false); + + const handleClick = async () => { + setStatus(null); + + // Resolve the injected provider. With several wallets installed, + // window.ethereum can be a non-MetaMask provider that auto-rejects + // wallet_addEthereumChain — so prefer MetaMask when a list is exposed + // (mirrors @metamask/detect-provider, used by the Celo faucet button). + 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) { + // Log the raw error so the exact code/message is visible in devtools. + console.error("wallet_addEthereumChain failed", err); + // 4001 is the EIP-1193 "user rejected request" code; anything else is a + // real failure, so surface the wallet's own message rather than masking it. + 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 ( + + ); +}; diff --git a/tooling/libraries-sdks/composer-kit.mdx b/tooling/libraries-sdks/composer-kit.mdx index 823c83a36..be5c8a14e 100644 --- a/tooling/libraries-sdks/composer-kit.mdx +++ b/tooling/libraries-sdks/composer-kit.mdx @@ -215,6 +215,6 @@ For comprehensive examples and detailed API documentation for each component: ## Next Steps -- Check out the [quickstart guide](/build/quickstart) to get started with Celo development +- Get started with [Celopedia](/build-on-celo/build-with-ai/celopedia) to build on Celo with your AI coding assistant - Explore [building on MiniPay](/build/build-on-minipay/overview) for mobile-first experiences - Learn about [DeFi integration](/build/build-with-defi) for financial applications diff --git a/tooling/overview/index.mdx b/tooling/overview/index.mdx index 0e5958d2c..7aa4dc44d 100644 --- a/tooling/overview/index.mdx +++ b/tooling/overview/index.mdx @@ -11,7 +11,7 @@ Explore our comprehensive suite of tools, guides, and resources designed to help Celo Composer allows you to quickly build, deploy, and iterate on decentralized applications using Celo. It provides a number of frameworks, examples, and Celo specific functionality to help you get started with your next dApp. -- [Quickstart with Celo Composer](/build/quickstart) +- [Get started with Celopedia](/build-on-celo/build-with-ai/celopedia) - [Celo Composer GitHub](https://github.com/celo-org/celo-composer) ## Developer Tools