Skip to content
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

chore(docs): reorganise learn sidebar and additions #457

Merged
merged 10 commits into from
Mar 1, 2024
2 changes: 1 addition & 1 deletion docs/site/docs/home.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,4 +11,4 @@ slug: /

_Welcome to the documentation portal for all things Omni!_

Please read on to learn [about Omni](./learn/introduction.md), [the network](./protocol/introduction.md), [developer docs](./develop/contracts.md) and [running a validator](./operate/introduction.md).
Please read on to learn [about Omni](./learn/introduction/introduction.md), [the network](./protocol/introduction.md), [developer docs](./develop/contracts.md) and [running a validator](./operate/introduction.md).
27 changes: 27 additions & 0 deletions docs/site/docs/learn/background/blockchains.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
---
sidebar_position: 1
---

# Blockchains

The concept of modular blockchains is a mental model for building blockchains that has grown in popularity over the past few years in the crypto industry. Let's discuss the history of the idea, and how it's relevant to Omni.

## Monolithic Blockchains

Historically, blockchains were built in a monolithic fashion. Most Layer 1 blockchains were built as an "end to end" service – taking responsibility for all services that a blockchain must provide. Layer 1 solutions like Bitcoin and Ethereum were built in this fashion.

As the industry evolved, new Layer 1s were developed that optimized their stacks to make different trade-offs in terms of security, scalability, and speed. Many of these new Layer 1s adopted the monolithic approach – optimizing the full chain stack to provide the optimal desired experience. Examples of these newer monolithic Layer 1s include [Solana](https://solana.com/), [Aptos](https://aptosfoundation.org/), and [Sui](https://sui.io/).

## Modular Blockchains

However, as time has passed the latest innovations have grown to more closely reflect the architecture of microservices in the traditional software engineering world. Blockchain developers realized that we could decouple the various components that make up a blockchain and optimize them independently.

This approach was first proposed in Ethereum's rollup-centric roadmap, and more recently has been popularized by projects such as [Arbitrum](https://arbitrum.io/), [Celestia](https://celestia.org/) and now Omni.

### Components

Today, our understanding of blockchains has led us to disambiguate the stack into three primary components, broadly speaking:

- **Data Availability**: ensuring that a blockchain's transaction data is available to network participants at block proposal time (read further [here](https://ethereum.org/en/developers/docs/data-availability/)).
- **Execution**: running a blockchain's state transition function (STF) on the input data (transactions from the Data Availability module) and computing its output.
- **Consensus**: mechanism for nodes to agree on the computed output of the execution layer (and optionally finalizing the chain's state).
15 changes: 15 additions & 0 deletions docs/site/docs/learn/background/ethereum.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
---
sidebar_position: 2
---

# Ethereum's Roadmap

As the Ethereum ecosystem developed, we learned that scaling transaction throughput and decreasing costs would be extraordinarily difficult on Layer 1 Ethereum while maintaining its high security. Over time, various proposals have attempted to solve this problem: state channels, side chains, and plasma to name a few. However, each of these options came with unfortunate trade-offs that typically sacrificed security to achieve these goals. But their development was not in vain! They led to the growth of rollups, the currently agreed upon optimal solution for scaling Ethereum.

## Rollup-Centric Roadmap

Hence, the [rollup-centric roadmap](https://ethereum-magicians.org/t/a-rollup-centric-ethereum-roadmap/4698) was proposed.

Today, Ethereum Layer 1 handles Data Availability, Execution, and Consensus. But over time, Ethereum will primarily become a Data Availability layer. Rollups will handle execution off-chain, and utilize either Ethereum's smart contract layer, or their own sovereign settlement layer, for consensus. This allows rollups (Layer 2s) to borrow Ethereum security while scaling throughput and decreasing cost. Upgrades like [EIP-4844](https://www.eip4844.com/) will even further improve Ethereum as a Data Availability layer by providing the service at lower cost.

You can view the growth of rollup ecosystems at [L2Beat.com](https://l2beat.com/), a great resource for understanding the security trade-offs, current state of development, and adoption levels for rollups.
32 changes: 32 additions & 0 deletions docs/site/docs/learn/background/fragmentation.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
---
sidebar_position: 4
---

# Fragmentation

As rollups have become increasingly popular for scaling blockchain networks, a new challenge has emerged: fragmentation of users and liquidity. While rollups enhance performance by processing transactions off the main chain, they often operate in isolation from one another. This isolation can lead to siloed ecosystems where assets and interactions are confined to individual rollups, hindering the potential for broader interoperability and network effects.

## The Fragmentation Challenge

Fragmentation can manifest in several ways:

- **Liquidity Split**: Assets are spread across multiple rollups, which can dilute the liquidity and make it harder for users to access the full value of the network.
- **User Experience**: With different rollups offering various features, users may have to navigate complex processes to move assets or data between them, impacting usability.
- **Developer Complexity**: Building applications that span multiple rollups requires dealing with disparate systems, which can increase development time and costs.

## Omni's Approach to Unification

The Omni protocol aims to address these fragmentation challenges by enabling seamless communication and interoperability between different rollups. Here's how Omni contributes to a more unified blockchain ecosystem:

- **Cross-Rollup Communication**: Omni allows users and applications to interact across various rollups as if they were a single, cohesive network.
- **Unified Liquidity Pools**: By facilitating cross-rollup transactions, Omni helps aggregate liquidity, improving capital efficiency and reducing slippage for users.
- **Simplified User Journeys**: Users can enjoy a smoother experience with the ability to move assets or execute actions across rollups without complex processes or multiple steps.
- **Developer-Friendly Platform**: Developers can build applications with the confidence that they will work across the entire rollup ecosystem, thanks to Omni's standardized communication protocols.

## Looking Forward

The vision for the future is an interconnected blockchain landscape where fragmentation is a thing of the past. Rollups will continue to play a critical role in scaling, and protocols like Omni are key to ensuring that the ecosystem remains unified and user-friendly.

For more information on how Omni tackles fragmentation and promotes a cohesive blockchain environment read further on [Omni's vision](../introduction/vision.md) and [EigenLayer's enhancing of security through restaking](https://eigenlayer.com/).

Omni is dedicated to bridging the gaps between isolated rollups, fostering a more connected and powerful blockchain infrastructure. Through its innovative protocols, Omni is paving the way for a future where the full potential of blockchain can be realized without the barriers of fragmentation.
25 changes: 25 additions & 0 deletions docs/site/docs/learn/background/interoperability.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
---
sidebar_position: 5
---

# Interoperability

Interoperability is the ability of different blockchain networks to communicate and interact with one another seamlessly. It's a foundational element for building a connected and accessible decentralized ecosystem. By allowing different chains to exchange information and value, interoperability breaks down barriers, enabling a more versatile and cohesive blockchain experience.

## Why Interoperability Matters

The rise of multiple blockchain networks, each with its unique features and advantages, has led to a fragmented landscape. Interoperability is critical in this context for several reasons:

- **Enhanced User Experience**: Users can transact across chains without needing multiple wallets or accounts, streamlining the user experience.
- **Increased Network Effects**: Interoperability allows networks to leverage each other's strengths, leading to greater adoption and utility.
- **Combined Liquidity**: It consolidates liquidity from various networks, improving market efficiency and reducing slippage for traders.

## Omni: Bridging Chains

Omni addresses the need for interoperability by providing a protocol that facilitates cross-chain communication. It enables different blockchain networks to work together, creating a web of interconnected chains.

### Key Features of Omni's Interoperability:

- **Cross-Chain Communication**: Omni allows for the transfer of data and assets between chains, fostering collaboration and interaction between distinct blockchain ecosystems.
- **Unified Development Platform**: Developers can create applications that operate across multiple chains, reducing complexity and development time.
- **Security, Transparency and Trust**: With the integration of EigenLayer's restaking model, Omni ensures that cross-chain interactions maintain a high level of security and reliability.
42 changes: 42 additions & 0 deletions docs/site/docs/learn/background/restaking.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
---
sidebar_position: 6
---

# What is Restaking?

Restaking is a transformative concept in blockchain security, introduced by EigenLayer, a protocol built on Ethereum. It represents a new cryptoeconomic security primitive allowing the reuse of staked **\$ETH** to extend cryptoeconomic security to a wide array of applications on the network.

## Introducing EigenLayer

EigenLayer is a groundbreaking protocol that unlocks the potential of staked **\$ETH**, enabling it to secure additional services beyond the consensus layer. It allows users to restake their native **\$ETH** or liquid staking tokens (LSTs) through smart contracts, thereby contributing to the security of various applications while earning additional rewards.

### Why Restaking Matters

Restaking through EigenLayer has several significant advantages:

- **Pooled Security**: Ethereum stakers can restake their staked **\$ETH** to provide pooled security across multiple services, reducing capital costs and elevating trust guarantees for each service.
- **Fragmentation Solution**: By allowing any service to tap into Ethereum's staked security, EigenLayer addresses the fragmentation of security efforts, fostering a cohesive ecosystem for decentralized services.
- **Permissionless Innovation**: EigenLayer's environment supports the seamless introduction of new services, enabling permissionless innovation and free-market governance where stakers choose which services to secure based on their risk-reward preferences.

## EigenLayer: A Hub of Decentralized Services

EigenLayer supports a variety of actively validated services (AVS), including but not limited to:

- Sidechains
- Oracle networks
- Data availability layers
- Bridges and keeper networks

### Core Features of EigenLayer

- **Liquid Staking**: Users can stake their **\$ETH** and receive LSTs, which can be traded or redeemed, allowing for liquidity and participation in DeFi ecosystems.
- **Native and LST Restaking**: Stakers can opt to restake their assets natively or use LSTs to secure additional services within EigenLayer's framework.
- **Delegation and Operators**: Stakers can delegate their staked assets to operators who run the infrastructure required for EigenLayer services, simplifying participation for those who may not wish to operate the software themselves.

## Securing the Future

EigenLayer's innovative approach to restaking and its on-chain slashing mechanisms ensure robust security aligned with the principles of decentralized governance. As a result, EigenLayer sets the stage for a more secure, efficient, and unified blockchain ecosystem.

For an in-depth understanding of restaking and the EigenLayer protocol read more in the [EigenLayer Documentation](https://docs.eigenlayer.xyz/eigenlayer/overview/).

EigenLayer is redefining the landscape of blockchain security by enabling stakers to contribute to the security of the entire network, ushering in a new era of interconnectedness and mutual growth.
21 changes: 21 additions & 0 deletions docs/site/docs/learn/background/rollups.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
---
sidebar_position: 3
---

# Rollups

Rollups are a type of layer 2 solution that aim to enhance the scalability and efficiency of blockchain networks. They do so by processing transactions outside the main blockchain (off-chain) and then posting the transaction data (on-chain) in a compressed form. This method significantly reduces the strain on the network, allowing for faster and cheaper transactions. Rollups are pivotal to the Omni protocol's ability to facilitate seamless cross-rollup communication.

There are mainly two types of rollups that differ in how transaction data is processed and verified: **Optimistic Rollups** and **ZK-Rollups**.

## Optimistic Rollups

Optimistic Rollups assume transactions are valid by default and only perform computation, and hence incur expenses, when a transaction is challenged. They offer a significant increase in scalability by running computation off-chain and posting the transaction data on-chain. Users or "watchers" can challenge a transaction if they believe it to be fraudulent.

[Learn more about Optimistic Rollups](https://ethereum.org/en/developers/docs/scaling/optimistic-rollups/)

## ZK-Rollups

ZK-Rollups, or Zero-Knowledge Rollups, bundle hundreds of transfers into a single transaction. Instead of publishing all data on the chain, they generate a cryptographic proof known as a SNARK (Succinct Non-interactive Argument of Knowledge). This proof confirms the validity of all transactions in the bundle. ZK-Rollups are highly efficient, as they allow the network to confirm the legitimacy of transactions without executing them fully.

[Discover more about ZK-Rollups](https://ethereum.org/en/developers/docs/scaling/zk-rollups/)
46 changes: 0 additions & 46 deletions docs/site/docs/learn/blockchains.md

This file was deleted.

9 changes: 9 additions & 0 deletions docs/site/docs/learn/introduction/goal.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
sidebar_position: 3
---

# Goal

> **The goal of Omni is to pair an innovative security model with a novel, modular architecture to provide the highest performance interoperability network for rollup application developers.**

Omni is a blockchain specifically designed to unify Ethereum's rollups, mitigating fragmentation by [restaking](../background/restaking.md) for enhanced security and simplicity, allowing developers to create cross-rollup applications effortlessly. It pioneers the use of ETH restaking to bolster security, streamlining the development process by abstracting cross-rollup complexities from users and developers. As the Ethereum ecosystem grows and diversifies, Omni positions itself as the essential infrastructure to support Ethereum's modular evolution, offering a seamless development experience amidst a landscape of increasing rollup networks.
11 changes: 11 additions & 0 deletions docs/site/docs/learn/introduction/introduction.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
---
sidebar_position: 1
---

# About

Omni is a high performance, high security interoperability network built to aggregate users, liquidity and activity from all rollups, providing developers with the best platform to build cross-rollup applications.

Omni is the future of interoperability for the Ethereum ecosystem that allows developers to build applications that are available across all rollups without fragmenting their liquidity.

Omni abstracts away the complexity of building cross-rollup applications by establishing a global storage layer to manage cross-domain applications, accessing liquidity and users across every ecosystem.Developers can work in a familiar environment – the EVM – and don't need to worry about distributed state management. Instead of fragmenting liquidity, application developers can aggregate it across domains, meeting users where they are and creating a smooth product experience.
Loading
Loading