From 62459857fb2b280cf0132ba16f4c4681c1a64bd1 Mon Sep 17 00:00:00 2001 From: Eshita Nandini Date: Tue, 4 Jun 2024 16:00:37 -0400 Subject: [PATCH] docs typos + wording consistency (#62) updated some typos + wording around sequencing layer --------- Co-authored-by: Sam Bukowski --- docs/.vitepress/config.mts | 4 +-- docs/community/1-overview.md | 5 ++-- docs/overview/bridging.md | 6 ++--- docs/overview/how-rollups-work.md | 8 +++--- docs/overview/introduction.md | 27 ++++++++----------- docs/overview/the-astria-sequencer-network.md | 6 ++--- 6 files changed, 26 insertions(+), 30 deletions(-) diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts index 56e651a3..9e5d3faf 100644 --- a/docs/.vitepress/config.mts +++ b/docs/.vitepress/config.mts @@ -4,7 +4,7 @@ const { BASE: base = "/" } = process.env; // https://vitepress.dev/reference/site-config export default defineConfig({ title: "Astria", - description: "The Sequencing Layer Network", + description: "The Sequencing Layer", lastUpdated: true, cleanUrls: true, ignoreDeadLinks: true, @@ -77,7 +77,7 @@ function sidebar() { collapsed: true, items: [ { - text: 'Using the Astria cli', + text: 'Using the Astria CLI', collapsed: true, items: [ {text: 'Install the CLI', link: '/developer/tutorials/install-the-cli.md'}, diff --git a/docs/community/1-overview.md b/docs/community/1-overview.md index 61e38ca1..5d609543 100644 --- a/docs/community/1-overview.md +++ b/docs/community/1-overview.md @@ -1,3 +1,4 @@ -# Community overview +# Community Overview -This section will highlight all the different resources and activities for the Astria community. +Reach out on [Twitter](https://x.com/AstriaOrg) or +[Discord](https://discord.gg/3qZCbmZxvF) if you would like addition help. diff --git a/docs/overview/bridging.md b/docs/overview/bridging.md index c131b96b..c961c08d 100644 --- a/docs/overview/bridging.md +++ b/docs/overview/bridging.md @@ -2,11 +2,11 @@ ## Fee payments -With a sequencing layer, transaction data touches three different chains: the +With the Astria Sequencing Layer, transaction data touches three different chains: the sequencer chain, the data availability chain, and the rollup chain. Each of these requires a fee payment for DoS prevention. If each chain requires a different token for fee payment, this causes a poor UX. Many rollups built on -Ethereum allow for bridged ETH to be used to pay fees, alleviating UX concerns, +Ethereum allows for bridged ETH to be used to pay fees, alleviating UX concerns, as users only need to obtain one, widely-available token (ETH). We can do something similar with the sequencer network. Assuming the data @@ -17,7 +17,7 @@ derivation) method. In our case, this means bridging TIA (Celestia) to Astria via IBC, and allowing it to be used for fee payments. Then, a rollup can optionally choose to accept (IBC-)TIA as a token for fee payments as well. -## Rollup bridging +## Rollup Bridging To bridge tokens to a rollup built on Astria, the rollup needs to add the ability to derive deposit transactions from the sequencer or DA network. In diff --git a/docs/overview/how-rollups-work.md b/docs/overview/how-rollups-work.md index f0bfd0f7..d6eb87b0 100644 --- a/docs/overview/how-rollups-work.md +++ b/docs/overview/how-rollups-work.md @@ -5,7 +5,7 @@ over some subset of data contained in another blockchain, the L1. Bridging to/from the L1 (by enshrining the rollup’s state transition in the L1) is implemented by non-sovereign rollups. -## Rollup full node architecture +## Rollup Full Node Architecture A rollup needs to perform the following: @@ -37,7 +37,7 @@ However, rollup nodes may still wish to form a p2p network for two reasons: fast confirmations, which can be received from the sequencer, or for rollup light nodes. -## Rollup sequencers +## Rollup Sequencers In the above section, we discussed how a rollup derives its transactions, but how does the rollup data end up on L1? @@ -65,7 +65,7 @@ the potential for transaction censorship. While there is always the “escape hatch” by which users post their rollup transactions directly to the L1 for inclusion on the rollup, this is a poor UX alternative. -## Decentralized sequencers +## Decentralized Sequencers A decentralized sequencer network is an alternative to the centralized service, where multiple sequencer nodes each have the ability to propose a batch of @@ -89,7 +89,7 @@ network. The first is to create a native asset on the sequencer network to be used for staking, as well as for transaction fees. The second is to use the asset of an underlying data availability layer for staking and transaction fees. -## Sequencing Layers +## Sequencing Layer ![Rollups with a decentralized sequencing layer](./assets/rollups-with-a-decentralized-sequencer.png) diff --git a/docs/overview/introduction.md b/docs/overview/introduction.md index a76b274f..49280f44 100644 --- a/docs/overview/introduction.md +++ b/docs/overview/introduction.md @@ -2,7 +2,7 @@ ![Astria Architecture](./assets/astria-architecture.png) -Astria is building a decentralized sequencer network that can be shared by many rollups. +Astria is building a decentralized sequencing layer that can be shared amongst multiple rollups. At a high level, the Astria stack performs the following functions: @@ -11,18 +11,14 @@ At a high level, the Astria stack performs the following functions: * allows rollup nodes to easily fetch and verify sequenced data * batches rollup blocks and posts these batches to Celestia -The first two are mandatory, while the last is implemented more for the -developer experience, allowing rollup developers to focus only on the -rollup-specific application logic, as opposed to the other aspects such as -rollup consensus. - The first requirement (sequencing of arbitrary data for rollups) is implemented -by the Astria sequencer network, a PoS network of sequencer nodes that use -CometBFT for consensus. The sequencer network comes to consensus on the ordering -and inclusion of rollup transactions of the form (rollup_id, tx_bytes). The -rollup_id can be any arbitrary string; it’s used only by rollup nodes to -determine which data is for them. The second (making data available to rollup -nodes) is achieved by publishing the sequenced data via Celestia. +by the Astria sequencer network, a decentralized network of sequencer nodes that +use CometBFT for consensus. The sequencer network comes to consensus on the +ordering and inclusion of rollup transactions of the form `(rollup_id, +tx_bytes)`. The `rollup_id` can be any arbitrary string; it’s used only by +rollup nodes to determine which data is for them. The second (making data +available to rollup nodes) is achieved by publishing the sequenced data via +Celestia. The third (allowing rollup nodes to easily fetch and verify sequenced data) is achieved by the Astria “Conductor”, which works similarly to existing rollup @@ -40,7 +36,7 @@ developers. For example, since the data is executed lazily, a rollup may choose to have 2 rollup blocks per Astria block, or 1 rollup block per Astria block. The rollup’s consensus and execution logic is not enshrined in the sequencer. -## What should I read? +## What Should I Read? Want to learn more about about rollups or the sequencer? Check out the [How Rollups Work](/overview/how-rollups-work) or [The Astria Sequencer @@ -54,9 +50,8 @@ a local Kubernetes cluster [here](../local-rollup/1-introduction.md). You can find our endpoints and FAQ [here](/astria-evm/overview.md) -## What If I Need More Help? +## Still Need More Help While this documentation hopefully includes everything you need, if you can't -find what you're looking for, please reach out to us on -[Twitter](https://twitter.com/AstriaOrg) or check the [Astria +find what you're looking for, please reach out on Discord [Discord](https://discord.gg/3qZCbmZxvF) or check the [Astria repository](https://github.com/astriaorg/astria). diff --git a/docs/overview/the-astria-sequencer-network.md b/docs/overview/the-astria-sequencer-network.md index 659fe1ba..604a7f41 100644 --- a/docs/overview/the-astria-sequencer-network.md +++ b/docs/overview/the-astria-sequencer-network.md @@ -1,7 +1,7 @@ -# The Astria Sequencer Network +# The Astria Sequencing Layer -The Astria sequencer network uses CometBFT (formerly Tendermint) as its -consensus algorithm. At a minimum, the sequencer network needs to implement a +The Astria Sequencing Layer uses CometBFT (formerly Tendermint) as its +consensus algorithm. At a minimum, the sequencing layer needs to implement a decentralized leader selection algorithm which rotates between proposers. Ideally, it is also able to provide single-slot (“fast”) finality, which prevents forks from occurring, allowing for simplified chain derivation logic on