From fefbc7db5d110e3e1b23156aaafd809902c7dea7 Mon Sep 17 00:00:00 2001 From: Eshita Nandini Date: Tue, 4 Jun 2024 15:26:43 -0400 Subject: [PATCH 1/5] typos + wording consistency --- docs/.vitepress/config.mts | 4 ++-- docs/overview/bridging.md | 6 +++--- docs/overview/how-rollups-work.md | 8 ++++---- docs/overview/introduction.md | 9 ++++----- docs/overview/the-astria-sequencer-network.md | 6 +++--- 5 files changed, 16 insertions(+), 17 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/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..88115cdd 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: @@ -40,7 +40,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 +54,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 From 6addf2a5cbaa85d00d8b548ef437e51ab846d7d7 Mon Sep 17 00:00:00 2001 From: Eshita Nandini Date: Tue, 4 Jun 2024 15:35:02 -0400 Subject: [PATCH 2/5] update typos + wording consistency --- docs/dusk-faq/1-information.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/dusk-faq/1-information.md b/docs/dusk-faq/1-information.md index b97bb017..96cda35a 100644 --- a/docs/dusk-faq/1-information.md +++ b/docs/dusk-faq/1-information.md @@ -10,7 +10,7 @@ sidebar_position: 5 Endpoints for the remote cluster are the following: -| NAME | HOSTS | ADDRESS | +| NAME | HOSTS | ADDRESS | |-----|-----|-----| | EVM JSON RPC | rpc.evm.dusk-3.devnet.astria.org | 34.160.214.22 | | EVM Block Explorer | explorer.evm.dusk-3.devnet.astria.org | 34.111.167.16 | From f5a7fdf8ac4d8c0066616d9ceb9b4d4a4748fbb3 Mon Sep 17 00:00:00 2001 From: Eshita Nandini Date: Tue, 4 Jun 2024 15:39:34 -0400 Subject: [PATCH 3/5] typos + wording consistency --- docs/community/1-overview.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/community/1-overview.md b/docs/community/1-overview.md index 61e38ca1..d55fa294 100644 --- a/docs/community/1-overview.md +++ b/docs/community/1-overview.md @@ -1,3 +1,4 @@ -# Community overview +# Community Overview + +Reach out on [Twitter](https://x.com/AstriaOrg) or [Discord](https://discord.gg/3qZCbmZxvF) if you would like addition help. -This section will highlight all the different resources and activities for the Astria community. From ec0953685976bd0b718aac9cc063216398e06ba8 Mon Sep 17 00:00:00 2001 From: Sam Bukowski Date: Tue, 4 Jun 2024 13:52:56 -0600 Subject: [PATCH 4/5] lint fixing, update some text to code in introduction --- docs/community/1-overview.md | 4 ++-- docs/dusk-faq/1-information.md | 2 +- docs/overview/introduction.md | 18 +++++++----------- 3 files changed, 10 insertions(+), 14 deletions(-) diff --git a/docs/community/1-overview.md b/docs/community/1-overview.md index d55fa294..5d609543 100644 --- a/docs/community/1-overview.md +++ b/docs/community/1-overview.md @@ -1,4 +1,4 @@ # Community Overview -Reach out on [Twitter](https://x.com/AstriaOrg) or [Discord](https://discord.gg/3qZCbmZxvF) if you would like addition help. - +Reach out on [Twitter](https://x.com/AstriaOrg) or +[Discord](https://discord.gg/3qZCbmZxvF) if you would like addition help. diff --git a/docs/dusk-faq/1-information.md b/docs/dusk-faq/1-information.md index 96cda35a..b97bb017 100644 --- a/docs/dusk-faq/1-information.md +++ b/docs/dusk-faq/1-information.md @@ -10,7 +10,7 @@ sidebar_position: 5 Endpoints for the remote cluster are the following: -| NAME | HOSTS | ADDRESS | +| NAME | HOSTS | ADDRESS | |-----|-----|-----| | EVM JSON RPC | rpc.evm.dusk-3.devnet.astria.org | 34.160.214.22 | | EVM Block Explorer | explorer.evm.dusk-3.devnet.astria.org | 34.111.167.16 | diff --git a/docs/overview/introduction.md b/docs/overview/introduction.md index 88115cdd..49280f44 100644 --- a/docs/overview/introduction.md +++ b/docs/overview/introduction.md @@ -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 From f40aa959bd3c7f6aed82773b80224ae84ee663d6 Mon Sep 17 00:00:00 2001 From: Eshita Nandini Date: Wed, 5 Jun 2024 09:45:49 -0400 Subject: [PATCH 5/5] Astria Descriptions --- docs/.vitepress/config.mts | 4 ++-- docs/index.md | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts index 9e5d3faf..13242789 100644 --- a/docs/.vitepress/config.mts +++ b/docs/.vitepress/config.mts @@ -120,7 +120,7 @@ function sidebar() { { text: 'Overview', link: '/community/1-overview' } ] }, - { text: 'Dusknet FAQ', link: '/dusk-faq/1-information' } + { text: 'Astria Devnet FAQ', link: '/dusk-faq/1-information' } ] } ] @@ -130,7 +130,7 @@ function nav() { return [ { text: 'Home', link: '/' }, { - text: "Join the network", + text: "Join the Network", items: [ { text: "Learn", link: "/overview/introduction" }, { text: "Developers", link: "/developer/tutorials/1-using-astria-cli-go" }, diff --git a/docs/index.md b/docs/index.md index 8e3cc260..3b95d06f 100644 --- a/docs/index.md +++ b/docs/index.md @@ -4,7 +4,7 @@ layout: home hero: name: "Astria" - text: "The Sequencing Layer Network" + text: "The Sequencing Layer" tagline: The easiest way to deploy decentralized rollups. image: src: /hero-img.svg