Skip to content

Change wording from L1 to L2 #1735

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 11 commits into
base: main
Choose a base branch
from
3 changes: 3 additions & 0 deletions .idea/.gitignore

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Original file line number Diff line number Diff line change
Expand Up @@ -56,4 +56,4 @@ This is also the reason that the `Kit` requires a valid provider from the beginn

## Local Signing

As part of the [Donut hardfork](https://medium.com/celoorg/dissecting-the-donut-hardfork-23cad6015fa2) network upgrade that occurred on May 19th, 2021, the Celo network now accepts Ethereum-style transactions as well as Celo transactions. This means that you can use Ethereum transaction signing tools (like [Metamask](/wallet/metamask/use), Web3.js and ethers.js) to sign transactions for the Celo network. Remember that Celo is a separate layer 1 blockchain from Ethereum, so do not send Ethereum assets directly to your Celo account address on Ethereum.
As part of the [Donut hardfork](https://medium.com/celoorg/dissecting-the-donut-hardfork-23cad6015fa2) network upgrade that occurred on May 19th, 2021, the Celo network now accepts Ethereum-style transactions as well as Celo transactions. This means that you can use Ethereum transaction signing tools (like [Metamask](/wallet/metamask/use), Web3.js and ethers.js) to sign transactions for the Celo network.
7 changes: 0 additions & 7 deletions docs/developer/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,13 +13,6 @@ Explore our comprehensive suite of tools, guides, and resources designed to help

---

:::warning
As of block height 31,056,500 (March 26, 2025, 3:00 AM UTC), Celo is no longer a standalone Layer 1 blockchain—it is now an Ethereum Layer 2!
Some documentation may be outdated as updates are in progress. If you encounter issues, please [file a bug report](https://github.com/celo-org/docs/issues/new/choose).

For the most up-to-date information, refer to our [Celo L2 documentation](https://docs.celo.org/cel2).
:::

## Quickstart

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.
Expand Down
12 changes: 3 additions & 9 deletions docs/developer/migrate/from-ethereum.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,15 +5,9 @@ description: Overview of the similarities and differences between the Celo and E

# Celo for Ethereum Developers

Overview of the similarities and differences between the Celo and Ethereum blockchains.
Celo is an Ethereum Layer 2 solution.

---
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd keep the warning, as the rest of the page would need to be rewritten to accurately reflect Celo now.

:::warning
As of block height 31,056,500 (March 26, 2025, 3:00 AM UTC), Celo is no longer a standalone Layer 1 blockchain—it is now an Ethereum Layer 2!
Some documentation may be outdated as updates are in progress. If you encounter issues, please [file a bug report](https://github.com/celo-org/docs/issues/new/choose).

For the most up-to-date information, refer to our [Celo L2 documentation](https://docs.celo.org/cel2).
:::

:::tip

Expand All @@ -23,8 +17,8 @@ For a general overview of the Celo network and architecture, see [the Celo Overv

## What is Celo's Relationship to Ethereum?

Celo is a layer 1 protocol and blockchain platform, and the Celo Mainnet is entirely separate from the Ethereum network.
While the Celo client originated as a fork of Ethereum Go language client, [go-ethereum](https://github.com/ethereum/go-ethereum) (or geth), it has several significant differences, including a proof-of-stake based PBFT consensus mechanism. All the cryptoassets on Celo have ERC-20 compliant interfaces, meaning that while they are not ERC-20 tokens on the Ethereum Mainnet, all familiar tooling and code that support ERC-20 tokens can be easily adapted for Celo assets, including the Celo Native Asset (CELO) and the Celo Dollar (cUSD).
While the Celo client originated as a fork of the Ethereum Go language client, [go-ethereum](https://github.com/ethereum/go-ethereum) (or geth), Celo has since become an Ethereum Layer 2 solution.
[Learn more about Celo's history.](/what-is-celo/history)

In terms of programmability, Celo is similar to Ethereum. Both networks run the Ethereum Virtual Machine (EVM) to support smart contract functionality.
This means that all programming languages, developer tooling and standards that target the EVM are relevant for both Celo and Ethereum.
Expand Down
55 changes: 55 additions & 0 deletions docs/general/history.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
---
title: Our History
---
import ColoredText from '/src/components/ColoredText';

Celo launched on Earth Day 2020 as an energy-efficient and low-cost Layer 1 blockchain. Since its inception, Celo has continually evolved to adapt to the changing landscape of blockchain technology and needs of its users in the broader crypto ecosystem.


## The Evolution of Celo: From Layer 1 to Layer 2

This timeline highlights the key milestones in Celo's development, from its launch as a Layer 1 blockchain to its exploration of becoming an Ethereum Layer 2 solution.

## Timeline of Celo's Journey:

#### July 2015: Ethereum Launch

Ethereum debuts as a Proof-of-Work blockchain, introducing smart contracts but facing high fees and energy consumption.

#### April 2020: [Celo Mainnet Launch](https://blog.celo.org/its-official-celo-mainnet-is-here-6a3a71763f68)

Celo officially launches its Mainnet on Earth Day, marking its debut as a Layer 1 blockchain network. Designed with a focus on energy efficiency and low transaction costs, Celo sets out to provide a more sustainable and accessible blockchain solution.

#### May 2021: [Celo Donut Hard Fork](https://blog.celo.org/donut-hardfork-is-live-on-celo-585e2e294dcb)

The Donut hard fork is implemented on Celo, enhancing its EVM (Ethereum Virtual Machine) compatibility and introducing cross-chain interoperability with other blockchain networks.

#### September 2022: [Ethereum Proof of Stake Transition](https://ethereum.org/en/roadmap/merge/)

Ethereum completes its transition from Proof of Work to Proof of Stake, significantly reducing its energy consumption and addressing some of the sustainability concerns that Celo originally set out to solve.

#### January 2023: [Celo 2.0 Announcement](https://forum.celo.org/t/the-next-chapter-introducing-celo-2-0/5124)

cLabs announces Celo 2.0 with improved Ethereum compatibility, better performance, and enhanced tokenomics.

#### July 2023: [Layer 2 Transition Proposal](https://forum.celo.org/t/clabs-proposal-for-celo-to-transition-to-an-ethereum-l2/6109)

In a strategic move, cLabs proposes transitioning Celo from an independent Layer 1 blockchain to an Ethereum Layer 2 to leverage Ethereum's security and expand its reach within the Ethereum ecosystem.

#### September 2023: [Gingerbread Hard Fork Proposal](https://forum.celo.org/t/introducing-celo-s-gingerbread-hard-fork-join-for-q-a-on-june-21/5918)

The Gingerbread hardfork is implemented to prepare for Celo L2 with a focus on improving Celo's compatibility with Ethereum by streamlining code and introducing <ColoredText>[Ultragreen Money](https://blog.celo.org/ultragreen-money-c677e7508abb)</ColoredText>, on-chain carbon offsetting through transaction fees, enhancing both performance and sustainability.

#### April 2024: [Celo joins Optimism OP Stack](https://x.com/Celo/status/1782394244352860589)

cLabs <ColoredText>[proposed the OP Stack](https://forum.celo.org/t/clabs-proposes-migrating-celo-to-an-ethereum-l2-leveraging-the-op-stack/7902)</ColoredText> for its Layer 2 migration to align more closely with Ethereum, reduce production time, enhance security, and maintain its unique features with minimal migration risk.

#### March 2025: [Celo announces L2 Mainnet Activation Date](https://x.com/Celo/status/1896617306509500661)

Celo L2 Mainnet Activation date will be on March 26, 2025 at 3am UTC.

## White Papers

For a deeper understanding of Celo's evolution and the technical foundations behind it, check out our <ColoredText>[white papers](https://celo.org/papers)</ColoredText>. These documents cover the innovations and decisions that have shaped Celo.

<ColoredText>[Read our White Papers](https://celo.org/papers)</ColoredText>
117 changes: 117 additions & 0 deletions docs/general/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,117 @@
---
title: Discover Celo
---

import ReactYouTube from "react-youtube";
import ColoredText from '/src/components/ColoredText';

Celo is a blockchain network designed for the real world, with a mission to build a regenerative digital economy that fosters prosperity for all.


# What is Celo?

Celo is an Ethereum Layer-2 designed to make blockchain technology accessible to all. With its focus on scalability, low fees, and ease of use, Celo is ideal for building blockchain products that reach millions of users around the globe.

<ReactYouTube videoId={'4a70pVEcRw4'} />


## Why Build on Celo?

Celo is fully EVM-compatible, offering the same development experience as Ethereum with improved scalability and lower costs.

#### Built for Everyday Users:

Celo is designed with features that lower the entry barrier for those new to cryptocurrency.

- **Fee Abstraction**: Users can pay transaction fees with several different tokens, making payments simple and flexible.
- **Sub-Cent Fees**: Celo maintains low gas fees, often below a cent, keeping transactions affordable.
- **Native Stablecoins**: Celo provides native stablecoins like cUSD, cEUR, cREAL, and cKES, offering a stable way to send and receive money. Check out [Mento](https://www.mento.org/) to learn more.


#### Mobile-First Approach:

Celo is optimized for mobile devices, making blockchain accessible to billions of smartphone users worldwide.

- **Phone number mapping**: Celo’s native protocol Social Connect, links wallets to phone numbers, making it easy to send and receive payments using just a phone number.

#### Optimized for Global Reach:

- **Scalability**: Celo’s focus on real-world use cases has already helped scale applications to over 100,000 daily active users (DAUs), proving its capability to support large-scale deployment.
- **Community Engagement**: Celo boasts an active global community of users and builders. With over 4 years of experience in bringing blockchain to real-world users, Celo offers a supportive environment for developers to test, launch, and scale their applications. Community members are engaged and eager to provide feedback, helping builders refine their products for broad, practical use. If you are interested in contributing, make sure to [reach out](https://celo.org/ecosystem).

#### Carbon Negative:

Celo is committed to environmental sustainability, offsetting more carbon than it produces.

- **Proof-of-Stake**: Celo uses an energy-efficient consensus mechanism that avoids energy-intensive mining, reducing its carbon footprint.
- **Ultragreen-Money**: A portion of every transaction fee goes towards carbon offsetting and sustainability projects, supporting environmental efforts with every transaction.

## Understanding the Celo Ecosystem

### What is CELO?

CELO is the platform-native asset that supports the growth and development of the Celo blockchain and ecosystem. CELO holders can earn rewards, stake with validators, and vote on proposals that shape the future of Celo.

<ReactYouTube videoId={'mkpTmbkRv4A'} />

### What Makes Celo's Native Stablecoins Unique?

Named for the currencies they follow, Celo Dollars (cUSD), Celo Euros (cEUR), Celo Reals (cREAL), and Celo Kenyan Shilling (cKES) are <ColoredText>[Mento](https://www.mento.org/)</ColoredText> stablecoins that allow you to share value faster, cheaper, and more easily on your mobile phone. Mento stablecoins instantly unlock access for everyday uses like low-cost remittances and cross-border payments, global distribution of charitable aid, effortlessly paying online, or transferring value within exchanges, particularly in markets subject to currency volatility.

<ReactYouTube videoId={'n1k1JcjTnp8'} />

## Get Started with Celo

Whether you're an experienced developer or just starting out, Celo provides the essential tools and resources to turn your ideas into reality.

<ColoredText>[Start building on Celo](/developer)</ColoredText> today and contribute to a growing ecosystem that supports a regenerative digital economy, fostering prosperity for all.

Connect with us on <ColoredText>[Discord](https://discord.com/invite/celo)</ColoredText> or on <ColoredText>[X](https://x.com/celo)</ColoredText>, and be sure to explore our <ColoredText>[ecosystem resources](https://celo.org/ecosystem)</ColoredText>.


<!-- ---
title: What is Celo?
description: Celo's mission is to build a financial system that creates the conditions for prosperity—for everyone.
---

import YouTube from '@site/src/components/YouTube';
import PageRef from '@site/src/components/PageRef';

Celo's mission is to build a financial system that creates the conditions for prosperity—for everyone.

---

## Cryptocurrency for a beautiful planet

Celo is an Ethereum Layer-2 and mobile-first blockchain network built for the real world and designed for fast, low-cost payments worldwide. Here are few of the key features of Celo:

- [Layer-1 to an Ethereum Layer-2 protocol](https://blog.celo.org/celobrate-cel2-4-years-of-mainnet-on-earth-day-861ffe557cdb)
- [Proof-of-stake](https://medium.com/celoorg/celos-proof-of-stake-mechanism-31061fbebea)
- [Carbon negative](https://medium.com/celoorg/cryptocurrency-for-a-beautiful-planet-e47299dfb1c3)
- [Mobile-first identity](protocol/identity/odis)
- [Localized stablecoins (cUSD, cEUR, cREAL, cKES)](https://medium.com/celoorg/celo-launches-the-creal-stablecoin-11da0d560c1c)
- [Gas payable in multiple currencies](protocol/transaction/erc20-transaction-fees)

## What is the Celo Platform?

Celo makes sending payments as easy as sending a text, to anyone with an internet connection, anywhere in the world. Celo maps phone numbers to wallet addresses using a novel decentralized address-based identity layer. Mobile participants can earn rewards for securing and maintaining the system.

<YouTube videoId="4a70pVEcRw4"/>

## What is CELO?

CELO is the platform-native asset that supports the growth and development of the Celo blockchain and ecosystem. CELO holders can earn rewards, stake with validators, and vote on proposals that shape the future of Celo.

<YouTube videoId="mkpTmbkRv4A"/>

## What can Celo Dollars do?

Named for the currencies they follow, Celo Dollars (cUSD), Celo Euros (cEUR) and Celo Reals (cREAL) are Mento stablecoins that allow you to share value faster, cheaper, and more easily on your mobile phone. Mento stablecoins instantly unlock access for everyday uses like low-cost remittances and cross-border payments, global distribution of charitable aid, effortlessly paying online, or transferring value within exchanges, particularly in markets subject to currency volatility.

<YouTube videoId="n1k1JcjTnp8"/>

:::tip Learn more 📚

Read [Celo: Building a Regenerative Economy](https://www.notboring.co/p/celo-building-a-regenerative-economy?s=r), [Celo Spotlight](https://medium.com/celodevelopers/celo-spotlight-build-a-financial-system-that-creates-the-conditions-for-prosperity-for-everyone-7b1830efc254), and the [Celo 2021 Annual Report](https://medium.com/celoorg/the-celo-foundation-annual-report-2021-celebrates-growth-impact-and-transparency-a9e47748700d) for an in-depth look at Celo and how it's creating the conditions of prosperity for everyone.

::: -->
7 changes: 0 additions & 7 deletions docs/network/mainnet/run-full-node.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,13 +7,6 @@ description: How to run a full node on the Celo Mainnet Network using a prebuilt

How to run on the Mainnet Network using a prebuilt Docker image.

:::warning
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Still relevant, this page is completely outdated.

As of block height 31,056,500 (March 26, 2025, 3:00 AM UTC), Celo is no longer a standalone Layer 1 blockchain—it is now an Ethereum Layer 2!
Some documentation may be outdated as updates are in progress. If you encounter issues, please [file a bug report](https://github.com/celo-org/docs/issues/new/choose).

For the most up-to-date information, refer to our [Celo L2 documentation](https://docs.celo.org/cel2).
:::

---

:::tip Hosted Nodes
Expand Down
7 changes: 0 additions & 7 deletions docs/network/node/run-alfajores.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,13 +7,6 @@ description: How to run a full node on the Alfajores Network using a prebuilt Do

How to run a full node on the Alfajores Network using a prebuilt Docker image.

:::warning
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Still relevant, the page is outdated and needs rewriting.

As of block height 31,056,500 (March 26, 2025, 3:00 AM UTC), Celo is no longer a standalone Layer 1 blockchain—it is now an Ethereum Layer 2!
Some documentation may be outdated as updates are in progress. If you encounter issues, please [file a bug report](https://github.com/celo-org/docs/issues/new/choose).

For the most up-to-date information, refer to our [Celo L2 documentation](https://docs.celo.org/cel2).
:::

---

## What is a Full Node?
Expand Down
7 changes: 0 additions & 7 deletions docs/network/node/run-baklava.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,13 +7,6 @@ description: How to get a full node running on the Baklava Network using a prebu

How to get a full node running on the Baklava Network using a prebuilt Docker image.

:::warning
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Still relevant, the page needs rewriting.

As of block height 31,056,500 (March 26, 2025, 3:00 AM UTC), Celo is no longer a standalone Layer 1 blockchain—it is now an Ethereum Layer 2!
Some documentation may be outdated as updates are in progress. If you encounter issues, please [file a bug report](https://github.com/celo-org/docs/issues/new/choose).

For the most up-to-date information, refer to our [Celo L2 documentation](https://docs.celo.org/cel2).
:::

---

## What is a Baklava Full Node?
Expand Down
7 changes: 0 additions & 7 deletions docs/network/node/run-hosted.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,13 +7,6 @@ description: How to get a preconfigured Celo blockchain node running on one of t

How to get a preconfigured Celo blockchain node running on one of the major cloud providers.

:::warning
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Still relevant, the page needs rewriting.

As of block height 31,056,500 (March 26, 2025, 3:00 AM UTC), Celo is no longer a standalone Layer 1 blockchain—it is now an Ethereum Layer 2!
Some documentation may be outdated as updates are in progress. If you encounter issues, please [file a bug report](https://github.com/celo-org/docs/issues/new/choose).

For the most up-to-date information, refer to our [Celo L2 documentation](https://docs.celo.org/cel2).
:::

---

## Before getting started
Expand Down
7 changes: 0 additions & 7 deletions docs/network/node/run-mainnet.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,13 +7,6 @@ description: How to run a full node on the Celo Mainnet Network using a prebuilt

How to run on the Mainnet Network using a prebuilt Docker image.

:::warning
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Still relevant, the page needs rewriting.

As of block height 31,056,500 (March 26, 2025, 3:00 AM UTC), Celo is no longer a standalone Layer 1 blockchain—it is now an Ethereum Layer 2!
Some documentation may be outdated as updates are in progress. If you encounter issues, please [file a bug report](https://github.com/celo-org/docs/issues/new/choose).

For the most up-to-date information, refer to our [Celo L2 documentation](https://docs.celo.org/cel2).
:::

---

:::tip Hosted Nodes
Expand Down
8 changes: 0 additions & 8 deletions docs/what-is-celo/about-celo-l1/l1-architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,14 +7,6 @@ description: Overview of the Celo Stack including it's blockchain, core contract

Overview of the Celo Stack including it's blockchain, core contracts, and applications.

:::warning
As of block height 31,056,500 (March 26, 2025, 3:00 AM UTC), Celo is no longer a standalone Layer 1 blockchain—it is now an Ethereum Layer 2!
Some documentation may be outdated as updates are in progress. If you encounter issues, please [file a bug report](https://github.com/celo-org/docs/issues/new/choose).

For the most up-to-date information, refer to our [Celo L2 documentation](https://docs.celo.org/cel2).
:::

---

## Introduction to the Celo Stack

Expand Down
8 changes: 0 additions & 8 deletions docs/what-is-celo/about-celo-l1/protocol/randomness.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,18 +3,10 @@ title: Celo Randomness
description: How unpredictable pseudo-randomness is achieved on the Celo blockchain.
---

:::warning
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Still relevant, randomness has been removed.

As of block height 31,056,500 (March 26, 2025, 3:00 AM UTC), Celo is no longer a standalone Layer 1 blockchain—it is now an Ethereum Layer 2!
Some documentation may be outdated as updates are in progress. If you encounter issues, please [file a bug report](https://github.com/celo-org/docs/issues/new/choose).

For the most up-to-date information, refer to our [Celo L2 documentation](https://docs.celo.org/cel2).
:::

# Randomness

How unpredictable pseudo-randomness is achieved on the Celo blockchain and offered as a service for dapp developers.

---

## Producing Pseudo-randomness

Expand Down
Loading