diff --git a/.idea/.gitignore b/.idea/.gitignore new file mode 100644 index 000000000..26d33521a --- /dev/null +++ b/.idea/.gitignore @@ -0,0 +1,3 @@ +# Default ignored files +/shelf/ +/workspace.xml diff --git a/docs/developer/contractkit/notes-web3-with-contractkit.md b/docs/developer/contractkit/notes-web3-with-contractkit.md index 98dfea104..52887baee 100644 --- a/docs/developer/contractkit/notes-web3-with-contractkit.md +++ b/docs/developer/contractkit/notes-web3-with-contractkit.md @@ -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. diff --git a/docs/developer/index.md b/docs/developer/index.md index b76855d15..3c7ceffa7 100644 --- a/docs/developer/index.md +++ b/docs/developer/index.md @@ -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. diff --git a/docs/developer/migrate/from-ethereum.md b/docs/developer/migrate/from-ethereum.md index a0706c257..1f7d2eebd 100644 --- a/docs/developer/migrate/from-ethereum.md +++ b/docs/developer/migrate/from-ethereum.md @@ -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. --- -:::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 @@ -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. diff --git a/docs/general/history.md b/docs/general/history.md new file mode 100644 index 000000000..5422f88de --- /dev/null +++ b/docs/general/history.md @@ -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 [Ultragreen Money](https://blog.celo.org/ultragreen-money-c677e7508abb), 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 [proposed the OP Stack](https://forum.celo.org/t/clabs-proposes-migrating-celo-to-an-ethereum-l2-leveraging-the-op-stack/7902) 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 [white papers](https://celo.org/papers). These documents cover the innovations and decisions that have shaped Celo. + + [Read our White Papers](https://celo.org/papers) diff --git a/docs/general/index.md b/docs/general/index.md new file mode 100644 index 000000000..244025bb5 --- /dev/null +++ b/docs/general/index.md @@ -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. + + + + +## 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. + + + +### 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 [Mento](https://www.mento.org/) 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. + + + +## 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. + +[Start building on Celo](/developer) today and contribute to a growing ecosystem that supports a regenerative digital economy, fostering prosperity for all. + +Connect with us on [Discord](https://discord.com/invite/celo) or on [X](https://x.com/celo), and be sure to explore our [ecosystem resources](https://celo.org/ecosystem). + + + diff --git a/docs/network/mainnet/run-full-node.md b/docs/network/mainnet/run-full-node.md index 5ef20f942..282396627 100644 --- a/docs/network/mainnet/run-full-node.md +++ b/docs/network/mainnet/run-full-node.md @@ -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 -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 diff --git a/docs/network/node/run-alfajores.md b/docs/network/node/run-alfajores.md index e5a082c2f..4cd9e9f1a 100644 --- a/docs/network/node/run-alfajores.md +++ b/docs/network/node/run-alfajores.md @@ -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 -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? diff --git a/docs/network/node/run-baklava.md b/docs/network/node/run-baklava.md index b47902a53..902f81819 100644 --- a/docs/network/node/run-baklava.md +++ b/docs/network/node/run-baklava.md @@ -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 -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? diff --git a/docs/network/node/run-hosted.md b/docs/network/node/run-hosted.md index 960fbded5..ef38b722b 100644 --- a/docs/network/node/run-hosted.md +++ b/docs/network/node/run-hosted.md @@ -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 -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 diff --git a/docs/network/node/run-mainnet.md b/docs/network/node/run-mainnet.md index 025d9d80f..0cc9a1ba7 100644 --- a/docs/network/node/run-mainnet.md +++ b/docs/network/node/run-mainnet.md @@ -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 -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 diff --git a/docs/what-is-celo/about-celo-l1/l1-architecture.md b/docs/what-is-celo/about-celo-l1/l1-architecture.md index 5bfee0e1b..479e3fe4c 100644 --- a/docs/what-is-celo/about-celo-l1/l1-architecture.md +++ b/docs/what-is-celo/about-celo-l1/l1-architecture.md @@ -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 diff --git a/docs/what-is-celo/about-celo-l1/protocol/randomness.md b/docs/what-is-celo/about-celo-l1/protocol/randomness.md index c9c0a0de5..e4107868d 100644 --- a/docs/what-is-celo/about-celo-l1/protocol/randomness.md +++ b/docs/what-is-celo/about-celo-l1/protocol/randomness.md @@ -3,18 +3,10 @@ title: Celo Randomness description: How unpredictable pseudo-randomness is achieved on the Celo blockchain. --- -:::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). -::: - # Randomness How unpredictable pseudo-randomness is achieved on the Celo blockchain and offered as a service for dapp developers. ---- ## Producing Pseudo-randomness diff --git a/docs/what-is-celo/using-celo/bridges.md b/docs/what-is-celo/using-celo/bridges.md index 39726e829..13ffbf28a 100644 --- a/docs/what-is-celo/using-celo/bridges.md +++ b/docs/what-is-celo/using-celo/bridges.md @@ -1,11 +1,8 @@ --- -title: Bridges -description: How to bridge assets between Celo and other blockchain networks such as Ethereum, Polygon, and Solana. +title: Bridging --- -# Bridges - -Bridging allows users to transfer assets between the Celo network and other blockchain networks such as Ethereum, Polygon, and Solana. This section provides an overview of available bridging and swapping options. +Bridging allows users to transfer assets between the Celo network and other blockchain networks. This section provides an overview of available bridging and swapping options. :::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! @@ -22,38 +19,26 @@ Be sure you understand and review the risks when bridging assets between chains. ::: -## Bridges To and From Celo +## Bridging To and From Celo ### Popular Bridges - [Squid Router V2](https://v2.app.squidrouter.com/?chains=10%2C42220&tokens=0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee%2C0x471ece3750da237f93b8e339c536989b8978a438) -- [LayerZero](https://layerzero.network/) +- [Portal Bridge](https://portalbridge.com/) - [Jumper Exchange](https://jumper.exchange/?fromChain=10&fromToken=0x0000000000000000000000000000000000000000&toChain=42220&toToken=0x471EcE3750Da237f93B8E339c536989b8978a438) -- [Portal Bridge (Wormhole)](https://portalbridge.com/) -- [AllBridge](https://app.allbridge.io/bridge?from=ETH&to=CELO&asset=ABR) -- [Satellite (Axelar)](https://satellite.money/) -- [Transporter (Chainlink CCIP)](https://www.transporter.io/) -- [Mach Exchange](https://www.mach.exchange/) -### Gasless Bridges +### Gasless Bridge - [SmolRefuel](https://smolrefuel.com/?outboundChain=42220) -### Native Bridges +### Native Bridge Native bridging refers to the process of transferring assets directly between Layer 2 (L2) networks without the need for intermediary networks or tokens. This method is designed to be more secure, efficient and cost-effective, leveraging the security and scalability of L2 solutions. + - [Superbridge Celo Mainnet](https://superbridge.app/celo) - [Superbridge Alfajores Testnet](https://testnets.superbridge.app/celo-alfajores) - [Superbridge Baklava Testnet](https://testnets.superbridge.app/celo-baklava) -## Cross-Chain Messaging - -In addition to token bridges, there are also protocols that enable cross-chain messaging and interoperability: -- [Chainlink CCIP](https://chain.link/cross-chain) -- [Hyperlane](https://www.hyperlane.xyz/) -- [Wormhole](https://wormhole.com/) -- [Layer Zero](https://layerzero.network/) -- [Axelar Network](https://axelar.network/)